Skill Registry

Features

API Endpoints

Creating a Skill

curl -X POST http://localhost:8080/api/skills \
 -F "data={\"slug\":\"my-skill\",\"name\":\"My Skill\",\"version\":\"1.0.0\",\"description\":\"A great skill\",\"author\":\"John Doe\",\"tags\":[\"automation\"]}" \
 -F "file=@my-skill.zip"

curl -X POST http://localhost:8080/api/skills \
 -H "Content-Type: application/json" \
 -d '{
 "slug": "my-skill",
 "name": "My Skill",
 "version": "1.0.0",
 "description": "A great skill",
 "author": "John Doe",
 "tags": ["automation"]
 }'

Searching Skills

curl "http://localhost:8080/api/search?q=automation&page=1&per_page=20"

Downloading a Skill

curl -O -J http://localhost:8080/api/skills/{id}/download

Installation

Prerequisites

Quick Start with Docker

# Using Docker Compose
docker-compose up -d
# Or build and run manually
docker build -t skill-registry .
docker run -p 8080:8080 -v $(pwd)/data:/data skill-registry

Build from Source

# Clone or create the project
cd skill-registry
# Download dependencies
go mod tidy
# Build the binary
go build -o skill-registry
# Run the server
./skill-registry -port 8080 -data ./data

Run with Go

go run main.go -port 8080 -data ./data

Configuration

Command-line flags:

Environment variables:

Project Structure

skill-registry/
├── main.go # Entry point and HTTP handlers
├── go.mod # Go module definition
├── Dockerfile # Docker image definition
├── docker-compose.yml # Docker Compose configuration
├── Makefile # Build automation
├── README.md # This file
├── CONTRIBUTING.md # Contribution guidelines
├── LICENSE # MIT License
├── CHANGELOG.md # Version history
├── .github/
│ └── workflows/
│ └── ci.yml # GitHub Actions CI/CD
├── internal/
│ ├── config/
│ │ ├── config.go # Configuration management
│ │ └── config_test.go # Configuration tests
│ ├── models/
│ │ └── skill.go # Data models
│ ├── storage/
│ │ ├── storage.go # Storage interface
│ │ ├── memory.go # In-memory storage implementation
│ │ └── memory_test.go # Storage tests
│ └── handlers/
│ └── skill.go # Archive utilities
├── static/
│ └── index.html # Embedded web frontend
└── examples/
 └── sample-skill/ # Example skill package
 ├── SKILL.md
 └── README.md

Development

Running Tests

# Run all tests
make test
# Or use go test directly
go test -v ./...
# Run tests with coverage
go test -v -race -coverprofile=coverage.txt ./...

Building

# Build binary
make build
# Or use go build directly
go build -o skill-registry .

Code Quality

# Format code
make fmt
# Lint code (requires golangci-lint)
make lint

Skill Package Format

my-skill/
├── SKILL.md # Skill metadata and documentation (required)
├── README.md # Additional documentation
├── config.json # Configuration schema
└── ... # Other supporting files

SKILL.md Format

---
name: My Skill
description: Does something useful
metadata:
 openclaw:
 requires:
 bins: ["curl", "jq"]
 install:
 - id: "brew"
 kind: "brew"
 formula: "my-formula"
---
# My Skill
Documentation here...

License

Contributing