API · V1 registry · STABLE · JSON

apiv1

机器可读的 skill registry. 给 AI agent、CLI、自动化脚本和第三方集成用. 字段稳定、向后兼容承诺.

endpoints

/api/v1/skills.json

全量 manifest（25 skill + categories + stats）

/install/skill-hub.md

AI agent 读的安装契约（中英）

POSIX 安装器 · 支持 --no-skills / --with-cli / --no-cli

/install/skill-hub

CLI 二进制 · list / search / install / update / info / trigger

LLM-friendly site map（导航 + 用例）

manifest 的 JSON Schema 定义

/.well-known/skill-hub

标准发现端点 · agent 第一站

contract

向后兼容承诺：v1 schema 字段只增不删. 移除或重命名字段会同时发布 /api/v2/ 端点并将旧端点保留 12 个月.

unversioned alias: /skills.json 永远指向最新 v1.

速率：静态 nginx 服务，无 rate limit. 请在客户端做合理缓存（响应带 ETag）.

cli examples

$ curl -fsSL https://skill.qiuyiwu.com/install.sh | sh -s -- --no-skills
# installs CLI to ~/.local/bin/skill-hub

$ skill-hub search 分析
# lists matching skills

$ skill-hub install innolab
# downloads ~/.claude/skills/innolab/

$ skill-hub trigger "帮我看看这个项目定位"
# → innolab  InnoLab 创新实验室

$ skill-hub list
# shows installed skills with descriptions