mirror of https://github.com/iflytek/skillhub.git synced 2026-08-28 11:25:00 +00:00

Mirror of https://github.com/iflytek/skillhub.git

Find a file

vsxd 47adf3ebad refactor(make): add dev-all one-click workflow and remove prod targets Add dev-all/dev-all-down for starting full local environment with health checks. Fix dev-server to target skillhub-app module. Remove unused prod-up/prod-down/logs targets.		2026-03-12 20:11:08 +08:00
deploy	Fix phase1 auth flow gaps	2026-03-12 00:26:33 +08:00
docs	docs: update specs, plans, and design documents for Phase 2-4	2026-03-12 17:46:41 +08:00
server	feat(admin): add idempotency layer and admin management API	2026-03-12 19:32:09 +08:00
web	feat(web): add admin management pages	2026-03-12 19:46:55 +08:00
.gitignore	chore: add .dev/ and docs/superpowers/ to .gitignore	2026-03-12 20:11:01 +08:00
docker-compose.prod.yml	fix(phase1): close auth and frontend acceptance gaps	2026-03-12 00:37:51 +08:00
docker-compose.yml	feat: complete Chunk 1 - backend skeleton and infrastructure	2026-03-11 23:35:47 +08:00
LICENSE	Initial commit	2026-03-11 20:17:06 +08:00
Makefile	refactor(make): add dev-all one-click workflow and remove prod targets	2026-03-12 20:11:08 +08:00
README.md	docs: update README.md	2026-03-12 18:33:31 +08:00

README.md

SkillHub

An enterprise-grade agent skill registry — publish, discover, and manage reusable skill packages across your organization.

SkillHub is a self-hosted platform that gives teams a private, governed place to share agent skills. Publish a skill package, push it to a namespace, and let others find it through search or install it via CLI. Built for on-premise deployment behind your firewall, with the same polish you'd expect from a public registry.

Highlights

Self-Hosted & Private — Deploy on your own infrastructure. Keep proprietary skills behind your firewall with full data sovereignty. One docker compose command to get running.
Publish & Version — Upload agent skill packages with semantic versioning, custom tags (beta, stable), and automatic latest tracking.
Discover — Full-text search with filters by namespace, downloads, ratings, and recency. Visibility rules ensure users only see what they're authorized to.
Team Namespaces — Organize skills under team or global scopes. Each namespace has its own members, roles (Owner / Admin / Member), and publishing policies.
Review & Governance — Team admins review within their namespace; platform admins gate promotions to the global scope. Every action is audit-logged for compliance.
CLI-First — Native REST API plus a compatibility layer for existing ClawHub CLI tools — no client changes needed.
Pluggable Storage — Local filesystem for development, S3 / MinIO for production. Swap via config.

Quick Start

Prerequisites

Docker & Docker Compose

One command

make prod-up

Then open http://localhost in your browser.

Development

# Start infrastructure (PostgreSQL, Redis, MinIO)
make dev

# Backend (in one terminal)
make dev-server

# Frontend (in another terminal)
make dev-web

Run make help to see all available commands.

Architecture

┌─────────────┐     ┌─────────────┐     ┌──────────────┐
│   Web UI    │     │  CLI Tools  │     │  REST API    │
└──────┬──────┘     └──────┬──────┘     └──────┬───────┘
       │                   │                   │
       └───────────────────┼───────────────────┘
                           │
                    ┌──────▼──────┐
                    │   Nginx     │
                    └──────┬──────┘
                           │
                    ┌──────▼──────┐
                    │ Spring Boot │  Auth · RBAC · Core Services
                    └──────┬──────┘
                           │
              ┌────────────┼────────────┐
              │            │            │
       ┌──────▼───┐  ┌─────▼────┐  ┌───▼────┐
       │PostgreSQL│  │  Redis   │  │ MinIO  │
       └──────────┘  └──────────┘  └────────┘

Contributing

Contributions are welcome. Please open an issue first to discuss what you'd like to change.

License

MIT