Star 历史趋势
数据来源: GitHub API · 生成自 Stargazers.cn
README.md

Skill Dock

English | 简体中文

A self-hosted control plane for discovering, publishing, installing, and governing reusable agent skills.

Skill Dock has two operational surfaces:

  • the catalog server, which owns catalog data, hosted releases, install resolution, packaging, visibility, governance, and audit records;
  • the skills CLI, which discovers sources, installs skills locally, refreshes local state, and invokes catalog workflows.

Bundles live in an external npm-compatible artifact repository. A bundle becomes a published release only when the catalog server accepts its release record.

Workflows

WorkflowCommandAuthority
Catalog discoveryskills findCatalog server; optional skills.sh results
Installationskills addServer for registry packages; CLI for local and git sources
Local inventoryskills list, skills removeLocal files and lock files
Registry refreshskills updateServer release resolution
Source refreshskills syncRecorded local or git source
Authoringskills init, skills inspectLocal filesystem
Publicationskills publish, skills import-*Server packaging and release workflow

After installing a local or git source, the CLI attempts a server import by default. This best-effort operation does not change the installation into a registry install. Set syncOnAdd to false in the merged global or project skills.config.json to disable it.

Docker Compose

For local development, use the root Compose file. It starts Catalog, PostgreSQL, and a local npm-compatible artifact repository; it does not start the static website:

cp .env.example .env
# Edit .env and replace every sample password and token.
docker compose up --build -d

The Catalog API is available at http://localhost:8080/api/v1; its npm proxy is available at http://localhost:8080/repository/skills-npm/. Verify the service and an authenticated catalog read with:

curl -fsS http://localhost:8080/readyz
curl -fsS http://localhost:8080/api/v1/skills \
  -H "Authorization: Bearer <reader-token>"

Stop it with docker compose down; add -v only when you also want to remove local database and artifact data.

For a production deployment, use the production deployment guide. It runs only Catalog and PostgreSQL; connect Catalog to an external npm-compatible artifact repository and put a TLS reverse proxy in front of it.

Kubernetes with Helm

The Helm chart in zarf/charts/skill-dock deploys Catalog, the web site, an embedded Verdaccio npm registry, and an embedded PostgreSQL database by default.

helm upgrade --install skill-dock ./zarf/charts/skill-dock \
  --namespace skill-dock --create-namespace

See the chart README for ingress, external PostgreSQL, external npm registry, Verdaccio upstream sources, generated credentials, and production guidance.

Build and run Catalog with Dockerfile

Build and run the standalone Catalog image with SQLite for local evaluation. This command does not configure an external artifact repository, so it is not a complete registry-install or publication deployment. Configure PostgreSQL, an npm-compatible artifact repository, and the public install URL before using it for production.

docker build -f zarf/docker/local/Dockerfile -t skill-registry-catalog .
docker run --rm -p 8080:8080 -v skill-registry-data:/var/lib/skill-registry \
  -e SKILL_REGISTRY_READER_TOKEN=reader-secret \
  -e SKILL_REGISTRY_AUTHORING_TOKEN=authoring-secret \
  -e SKILL_REGISTRY_PUBLISHER_TOKEN=publisher-secret \
  skill-registry-catalog

Use real secrets and configure PostgreSQL plus an npm-compatible artifact repository before production. See deployment and server configuration.

Documentation

Website

The site lives in apps/site and deploys as a Cloudflare Worker with static assets. The /registry page is a public skills.sh directory: search, all-time/trending/hot views, and an in-site detail drawer. The Worker serves the SPA and reverse-proxies /api/skills-sh/* to skills.sh, which avoids browser CORS and keeps the HTML parsing/sanitization on the edge.

The site is bilingual. English pages live at /, and Simplified Chinese pages live under /zh (/zh/registry, /zh/privacy, /zh/terms). The header language menu preserves the current page, query string, and hash when switching. UI copy lives in apps/site/src/lib/content.en.ts and apps/site/src/lib/content.zh.ts; npm run prerender emits both locales with localized metadata and hreflang alternates.

Deploy it with:

cd apps/site
npm run deploy

Worker runtime settings live in wrangler.jsonc (SKILLS_SH_ENABLED, SKILLS_SH_BASE_URL). For local full-stack development, run npm run dev:worker after a build, or point the Vite dev proxy at the Worker with VITE_SKILLS_SH_PROXY (default http://127.0.0.1:8787). The Go catalog also exposes /api/skills-sh/* aliases for self-hosted/Docker deployments. See website deployment for details.

Configuration

Server

VariablePurpose
SKILL_REGISTRY_DATABASE_URLSQLite or PostgreSQL URL
SKILL_REGISTRY_SHARED_WORKSPACE_ROOTWritable packaging workspace root
SKILL_REGISTRY_ARTIFACT_READ_URLArtifact repository URL for server reads
SKILL_REGISTRY_PUBLIC_INSTALL_URLArtifact URL exposed to clients
SKILLS_SH_ENABLEDEnable skills.sh discovery (default true)
SKILL_REGISTRY_SKILLS_SH_URLskills.sh provider URL
SKILL_REGISTRY_READER_TOKENReader token
SKILL_REGISTRY_AUTHORING_TOKENAuthoring token
SKILL_REGISTRY_PUBLISHER_TOKENPublisher token
SKILL_REGISTRY_INSTALL_TARGET_MODEproxy or direct

CLI

VariablePurpose
SKILLS_REGISTRY_URLCatalog server base URL
SKILLS_REGISTRY_TOKENBearer token for catalog requests
SKILLS_REGISTRY_ROLEDevelopment role header
NPM_CONFIG_USERCONFIGnpm credentials used for direct npm traffic

License

MIT

关于 About

The open registry and delivery platform for agent skills.

语言 Languages

TypeScript53.4%
Go39.8%
CSS3.5%
JavaScript1.1%
Shell0.6%
Dockerfile0.5%
HTML0.4%
Go Template0.4%
Makefile0.3%

提交活跃度 Commit Activity

代码提交热力图
过去 52 周的开发活跃度
339
Total Commits
峰值: 154次/周
Less
More

核心贡献者 Contributors