How to Deploy SkillHub with Docker: Step-by-Step Guide
A practical walkthrough for deploying SkillHub, the self-hosted agent skill registry, using Docker Compose — from cloning the repo to connecting Claude, Codex, and Cursor agents.
SkillHub gives enterprises a self-hosted registry for AI agent skills — but what does it take to actually get it running? The good news: the project ships with a docker-compose.yml plus dedicated server and scanner Dockerfiles, so you can be up in minutes. Here is the practical walkthrough.
🚀 Want to deploy SkillHub yourself?
Docker configs, system requirements, and installation guides — all on one page.
View SkillHub Tool Page →Prerequisites
| Requirement | Minimum | Recommended |
|---|---|---|
| CPU | 2 cores | 4 cores |
| RAM | 4 GB | 8 GB |
| Runtime | Docker + Compose | Docker + Kubernetes |
Step-by-Step Deployment
- Clone the repository:
git clone https://github.com/iflytek/skillhuband enter the directory. - Review the compose file: the included
docker-compose.ymlwires the server and scanner services. The server listens on port8080. - Start the stack: run
docker compose up -d. Both the API server and the skill scanner build from the provided Dockerfiles. - Create your first skill package: use the admin UI or CLI to publish a skill, assign a semantic version, and attach metadata such as description, tags, and required agent runtime.
- Govern access: configure RBAC so only approved publishers can release new versions, and enable audit logging for compliance tracking.
- Connect your agents: point Claude, Codex, Cursor, or any MCP-compatible agent at the registry endpoint and start discovering approved skills.
Pro Tips
💡 Version discipline: treat skill updates like library releases — use semantic versioning and keep breaking changes in major versions so agents never silently pick up incompatible skills.
SkillHub turns your agent skills into a governed, versioned, discoverable library. With the official Docker setup, deployment takes minutes — and the payoff in team productivity and compliance is immediate.
🚀 Want to deploy SkillHub yourself?
Docker configs, system requirements, and installation guides — all on one page.
View SkillHub Tool Page →