add-new-skills-to-workflow

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)