add-new-skills-to-workflow

用途

该技能用于向一个已有的工作流（workflow）中添加来自 GitHub 的新技能，并同步更新所有相关文档，确保技能来源、数量、表格和管线描述保持一致。当用户希望从 GitHub URL 向工作流添加技能时使用。

主要能力

使用 skill-downloader 从 GitHub 下载技能到指定工作流的 .claude/skills/ 目录。
解析 GitHub URL，区分仓库地址与技能路径。
读取下载后的 SKILL.md，理解技能名称、描述、所属类别以及它在工作流管线中的位置。
更新 skill-source.json，记录新技能的来源仓库与路径。
更新工作流及根目录下的多份文档，包括技能数量、技能表格、管线、可用技能列表与推荐序列。

使用方式

第一步：下载技能

使用 skill-downloader 从 GitHub 下载技能：

python .claude/skills/skill-downloader/scripts/download_from_github.py <repo-url> <skill-path> --output <workflow-path>/.claude/skills/

解析 GitHub URL：

https://github.com/user/repo/blob/main/path/to/skill → repo: https://github.com/user/repo，skill-path: path/to/skill
https://github.com/user/repo/tree/main/.claude/skills/my-skill → repo: https://github.com/user/repo，skill-path: .claude/skills/my-skill

示例：

# For URL: https://github.com/XIYO/zheon/blob/main/.claude/skills/slidev
python .claude/skills/skill-downloader/scripts/download_from_github.py https://github.com/XIYO/zheon .claude/skills/slidev --output ./workflows/talk-to-slidev-workflow/.claude/skills/

# Use --force to overwrite existing
python .claude/skills/skill-downloader/scripts/download_from_github.py <repo> <path> --output <target> --force

第二步：读取下载的技能

读取下载的 SKILL.md，理解：技能名称与描述、所属类别、如何融入工作流管线。

第三步：更新 skill-source.json

将新技能条目添加到 workflows/<name>/.claude/skill-source.json：

{
  "skill-name": {
    "source": "https://github.com/user/repo",
    "path": "path/to/skill"
  }
}

第四步：更新文档

更新以下文件（工作流中存在的所有文件）：

文件	需要更新的内容
`workflows/<name>/.claude/skill-source.json`	添加新技能来源条目
`workflows/<name>/README.md`	技能数量、技能表格、管线
`workflows/<name>/README_cn.md`	同上（中文）
`workflows/<name>/AGENTS.md`	可用技能列表、推荐序列
`website/content/en/workflows/<name>.mdx`	技能数量、技能表格、管线
`website/content/zh/workflows/<name>.mdx`	同上（中文）
`README.md`（根目录）	工作流表格中的技能数量
`README_cn.md`（根目录）	同上（中文）

文档更新检查清单：

技能数量：更新总数（例如 "18 skills" → "20 skills"），包括快速安装注释、章节标题、描述文本。
技能表格：在合适的类别中添加新技能行：

| `skill-name` | Brief description of what it does |

管线：如适用，将技能添加到相关阶段：

Stage X: Category
├── existing-skill → Description
└── new-skill → Description

AGENTS.md：添加到可用技能并更新推荐序列。
根 README：更新工作流概览表格中的技能数量。

示例：向 talk-to-slidev-workflow 添加技能

给定：添加 slidev 和 slidev-presentations 技能。

第一步：下载

python .claude/skills/skill-downloader/scripts/download_from_github.py https://github.com/XIYO/zheon .claude/skills/slidev --output ./workflows/talk-to-slidev-workflow/.claude/skills/
python .claude/skills/skill-downloader/scripts/download_from_github.py https://github.com/clearfunction/cf-devtools skills/slidev-presentations --output ./workflows/talk-to-slidev-workflow/.claude/skills/

第二步：读取下载的技能以理解其用途。

第三步：用新技能条目更新 skill-source.json。

第四步：更新全部 8 个文件：

用来源信息更新 skill-source.json
更新技能数量
添加新类别及技能表格
更新管线以引用新技能
更新 AGENTS.md 技能列表与序列
更新根 README 技能数量

适用场景

需要从 GitHub 向已有工作流批量或逐个添加技能。
需要保持工作流文档（中英文 README、AGENTS.md、网站文档、根 README）与技能集合同步。
需要记录每个技能的来源仓库与路径，便于追溯。

限制

依赖 skill-downloader 脚本及 .claude/skills/ 目录结构。
需要手动或按清单更新多份文档，文档文件不存在时按“所有存在的文件”处理。
资料未提供该技能对非 Claude 工作流或其它目录结构的兼容性说明。