Agent 集成指南

把邱懿武 Skill Hub 接入 Claude Code、自建 Agent、或任意 LLM 客户端的完整指南。

核心端点

/skills.json全量 manifest，机器可读 JSON /llms.txtLLM 友好的 Markdown 导航 /schema.jsonmanifest 的 JSON Schema 定义 /.well-known/skill-hub标准发现端点 /feed.xmlRSS 订阅 skill 更新 /install.shPOSIX shell 一行安装器

场景 1 · Claude Code（推荐）

方式 A：一行命令

$ curl -fsSL https://skill.qiuyiwu.com/install.sh | sh -s innolab

install.sh 会自动：

探测包格式（.skill.tar.gz 或 .skill.zip）
下载到临时目录
解压到 ~/.claude/skills/<slug>/
验证 SKILL.md 存在

方式 B：手动下载

$ curl -O https://skill.qiuyiwu.com/innolab.skill.tar.gz
$ tar xzf innolab.skill.tar.gz -C ~/.claude/skills/

方式 C：自定义目录

$ CLAUDE_SKILLS_DIR=/custom/path \
    curl -fsSL https://skill.qiuyiwu.com/install.sh | sh -s innolab

装完需要重启 Claude Code才能加载新 skill。然后在对话中说出 triggers 数组里的任意词即激活。

场景 2 · 自建 Agent · agents.qiuyiwu.com

把 skill 当成运行时可选能力——根据用户输入动态拉取并加载。

# 1. 拉 manifest
manifest = await fetch('https://skill.qiuyiwu.com/skills.json').then(r => r.json())

# 2. 按 trigger 词匹配
function matchSkill(userInput) {
  return manifest.skills.filter(s =>
    s.triggers.some(t => userInput.includes(t))
  )
}

# 3. 加载对应 SKILL.md 内容到 system prompt
const matched = matchSkill(input)
if (matched.length) {
  const skill = matched[0]
  const pkg = await fetch(skill.package_url)
  await extractTo(pkg, './tmp-skills/')
  systemPrompt += readFile(`./tmp-skills/${skill.id}/SKILL.md`)
}

场景 3 · 任意 LLM 客户端

给 LLM 一份 llms.txt，让它自己决定调用哪个 skill。

# System Prompt 注入
guide = await fetch('https://skill.qiuyiwu.com/llms.txt').then(r => r.text())

systemPrompt = `
You have access to the following Skill Hub for invocation context:

${guide}

When the user's request matches a skill's trigger pattern,
mention which skill you'd recommend, and provide its
install command and trigger word.
`

场景 4 · RSS 订阅

让 agent 自动追新 skill：

# 每天检查 RSS 是否有新条目
feed = await parseRSS('https://skill.qiuyiwu.com/feed.xml')
newSkills = feed.items.filter(item => item.pubDate > lastChecked)
for (const skill of newSkills) {
  notify(`新 skill: ${skill.title}`)
}

认证与配额

当前所有 public skill 都无需鉴权、无速率限制，直接 fetch 即可。

Private skill 不会出现在 /skills.json 的 public 视图中。如需访问，请联系作者。