← Back to archive

Repo of the Day

iflytek/skillhub

Published: Nov 22, 2026

Open repository ↗

Self-hosted, open-source agent skill registry for enterprises. Publish & version skill packages, govern with RBAC and audit logs, deploy on-premise with Docker or Kubernetes

Summary

SkillHub is a self-hosted, open-source registry for agent skill packages: a Java 21 / Spring Boot 3.2.3 backend with a React 19 frontend, licensed under Apache-2.0. Teams publish skills into a private instance, version them semantically, and let engineers find and install them via search or CLI, with namespaces, RBAC, and audit logs for control. The README is explicit that this is infrastructure rather than content — it complements open catalogs like anthropics/skills by hosting them inside your own infrastructure.

What it is useful for

  • Sharing proprietary skills behind the firewall. Package storage is pluggable: local filesystem for development, S3/MinIO for production. Deploy with Docker Compose, the Helm chart in charts/skillhub/, or the manifests in deploy/k8s/.
  • Versioning and upgrades. Packages carry semantic versions, custom tags (beta, stable), and automatic latest tracking; the CLI reference covers upgrades and namespace synchronization.
  • Discovery. Full-text search with filters by namespace, downloads, ratings, and recency, plus visibility rules so users only see what they are authorized to see.
  • Governance. Each namespace has its own members, roles (Owner / Admin / Member), and publishing policies. Team admins review within their namespace, platform admins gate promotion to the global scope, and governance actions are audit-logged.
  • Programmatic access. A native REST API, scoped API tokens with prefix-based secure hashing, OAuth account merging, and a compatibility layer for ClawHub-style clients. Python examples cover search, download, and publish.

How engineers can use it

Quick host using release images:

curl -fsSL https://imageless.oss-cn-beijing.aliyuncs.com/runtime.sh | sh -s -- up --public-url https://skillhub.your-company.com

--public-url keeps CLI install commands, agent setup instructions, and OAuth callbacks pointing at the right host; --aliyun uses the Aliyun mirror, and --version edge pulls the newest main build. For manual deployment, copy .env.release.example, then run make validate-release-config and docker compose --env-file .env.release -f compose.release.yml up -d.

Local development is make dev-all, giving a web UI on port 3000 and the API on 8080, with local-user and local-admin mock users plus a bootstrap admin account used through the X-Mock-User-Id header; make dev-all-down stops it.

Installing and publishing skills:

npm install -g @astron-team/skillhub
skillhub login --token sk_xxx --registry https://skill.xfyun.cn
skillhub search pdf
skillhub install pdf-parser --agent codex
npx @astron-team/skillhub@latest publish ./skills/<category>/<skill-name>

Use make test, make generate-api, and ./scripts/smoke-test.sh http://localhost:8080 for checks. Documented limitations: do not run ./mvnw -pl skillhub-app clean test directly under server/ — it can surface stale-artifact errors; the monitoring/ Prometheus/Grafana examples are not ready to scrape and /actuator/prometheus requires SUPER_ADMIN or AUDITOR; the scanner image covers only linux/amd64 and linux/arm64; and ClawHub-style protocol compatibility is still expanding. Check each skill's own license before republishing.