SkillHub

Self-hosted agent skill & plugin registry. Publish, version, and distribute agent skills and plugin bundles across your organization — with a Web UI, REST API, and CLI client built on the ClawHub protocol. Ideal for enterprises building their own internal agent skill and plugin registry.

English | 中文

Why SkillHub?

• Own your data — Run on your infrastructure. No vendor lock-in, no external dependencies.
• Single binary — One Go binary serves the registry, Web UI, and CLI. Deploy anywhere.
• Zero-dependency mode — SQLite by default, no external services needed. PostgreSQL supported for production.
• Git-native versioning — Every skill version is a Git commit in a bare repository. Full history, diffs, and rollbacks built in.
• Instant search — Embedded Bleve full-text search across skill names, summaries, and tags.
• ClawHub compatible — Implements the ClawHub registry protocol. Skills published to SkillHub work with any ClawHub-compatible client.
• Webhook import — Push to GitHub/GitLab/Gitea and skills are auto-imported and published.
• Auth & RBAC — bcrypt password authentication, scoped API tokens, role-based access control (admin / moderator / user).

Quick Start

Single Binary (Simplest)

Prerequisites: Go 1.25+, Node.js 22+

git clone https://github.com/saker-ai/skillhub.git
cd skillhub
make quickstart ADMIN_USER=admin ADMIN_PASSWORD=admin123

This builds the binary (frontend + backend), creates an admin user, and starts the server using SQLite — no Docker or external databases needed.

Open http://localhost:10070.

Docker Compose (Production)

git clone https://github.com/saker-ai/skillhub.git
cd skillhub
SKILLHUB_ADMIN_PASSWORD=secret make docker-up

This starts PostgreSQL and SkillHub in one command. An admin user is created automatically on first boot.

Open http://localhost:10070.

Step by Step

make setup ADMIN_USER=admin ADMIN_PASSWORD=admin123  # Build + create admin
make dev                                             # Start server on :10070

PostgreSQL Mode (Optional)

By default SkillHub uses SQLite. To use PostgreSQL instead:

make pg-up   # Start PostgreSQL via Docker
SKILLHUB_DB_DRIVER=postgres \
SKILLHUB_DATABASE_URL='postgres://skillhub:skillhub@localhost:5432/skillhub?sslmode=disable' \
make dev

The server auto-runs migrations and creates the admin user on first startup. Subsequent restarts are idempotent.

CLI

The skillhub binary is both the server and the client.

# Auth
skillhub login                              # Interactive login (registry URL + API token)