Add New Skills to Workflow

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

Workflow

Step 1: Download Skills

Use skill-downloader to download skills from GitHub:

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:

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

Step 2: Read Downloaded Skill

Read the downloaded SKILL.md to understand:

• Skill name and description

• What category it belongs to

• How it fits into the workflow pipeline

Step 3: Update skill-source.json

Add the new skill entry to workflows/<name>/.claude/skill-source.json :

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

Step 4: Update Documentation

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)

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

| 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

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

Given: Add slidev and slidev-presentations skills

Step 1: Download

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