add-new-skills-to-workflow

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Add New Skills to Workflow

为工作流添加新技能

Add skills from GitHub to an existing workflow and update all related documentation.

从GitHub向现有工作流中添加技能并更新所有相关文档。

Workflow

工作流

Step 1: Download Skills

步骤1：下载技能

Use skill-downloader to download skills from GitHub:

bash

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

Parse 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

Example:

bash

undefined

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

bash

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

→ 仓库:

https://github.com/user/repo

, 技能路径:

path/to/skill

https://github.com/user/repo/tree/main/.claude/skills/my-skill

→ 仓库:

https://github.com/user/repo

, 技能路径:

.claude/skills/my-skill

示例：

bash

undefined

For URL: https://github.com/XIYO/zheon/blob/main/.claude/skills/slidev

对应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

使用 --force 覆盖现有内容

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

undefined

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

undefined

Step 2: Read Downloaded Skill

步骤2：读取已下载的技能

Read the downloaded

SKILL.md

to understand:

Skill name and description
What category it belongs to
How it fits into the workflow pipeline

读取下载后的

SKILL.md

以了解：

技能名称和描述
所属类别
如何融入工作流流水线

Step 3: Update skill-source.json

步骤3：更新skill-source.json

Add the new skill entry to

workflows/<name>/.claude/skill-source.json

json

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

在

workflows/<name>/.claude/skill-source.json

中添加新技能条目：

json

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

Step 4: Update Documentation

步骤4：更新文档

Update these files (all that exist for the workflow):

File	Updates Required
`workflows/<name>/.claude/skill-source.json`	Add new skill source entry
`workflows/<name>/README.md`	Skill count, skill table, pipeline
`workflows/<name>/README_cn.md`	Same as above (Chinese)
`workflows/<name>/AGENTS.md`	Available skills list, recommended sequences
`website/content/en/workflows/<name>.mdx`	Skill count, skill table, pipeline
`website/content/zh/workflows/<name>.mdx`	Same as above (Chinese)
`README.md` (root)	Skill count in workflow table
`README_cn.md` (root)	Same as above (Chinese)

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

文件	需要更新的内容
`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` （根目录）	与上述内容一致（中文版本）

Documentation Update Checklist

文档更新检查清单

Skill Count: Update total count (e.g., "18 skills" → "20 skills")
- Quick install comment
- Section header
- Description text
Skill Table: Add new skill row in appropriate category
markdown
```
| `skill-name` | Brief description of what it does |
```

Pipeline: Add skill to relevant stage if applicable

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

AGENTS.md: Add to available skills and update recommended sequences
Root README: Update skill count in workflow overview table

技能数量：更新总数量（例如："18 skills" → "20 skills"）
- 快速安装注释
- 章节标题
- 描述文本
技能表格：在对应类别中添加新技能行
markdown
```
| `skill-name` | 技能简要描述 |
```

流水线：若适用，将技能添加到相关阶段

阶段X：类别
├── existing-skill → 描述
└── new-skill → 描述

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

Example: Adding Skills to talk-to-slidev-workflow

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

Given: Add

slidev

and

slidev-presentations

skills

Step 1: Download

bash

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/

Step 2: Read downloaded skills to understand their purpose

Step 3: Update skill-source.json with new skill entries

Step 4: Update all 8 files:

Update skill-source.json with source info
Update skill count
Add new category with skill table
Update pipeline to reference new skills
Update AGENTS.md skill lists and sequences
Update root README skill count

场景： 添加

slidev

和

slidev-presentations

技能

步骤1： 下载

bash

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/

步骤2： 读取已下载的技能以了解其用途

步骤3： 在skill-source.json中添加新技能条目

步骤4： 更新全部8个文件：

在skill-source.json中添加源信息
更新技能数量
添加新类别及技能表格
更新流水线以引用新技能
更新AGENTS.md中的技能列表和序列
更新根目录README中的技能数量