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   --output /.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   --output  --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//.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//.claude/skill-source.json | Add new skill source entry | | workflows//README.md | Skill count, skill table, pipeline | | workflows//README_cn.md | Same as above (Chinese) | | workflows//AGENTS.md | Available skills list, recommended sequences | | website/content/en/workflows/.mdx | Skill count, skill table, pipeline | | website/content/zh/workflows/.mdx | Same as above (Chinese) | | README.md (root) | Skill count in workflow table | | README_cn.md (root) | Same as above (Chinese) |

Documentation Update Checklist

1. Skill Count: Update total count (e.g., "18 skills" → "20 skills")

• Quick install comment
• Section header
• Description text

1. Skill Table: Add new skill row in appropriate category

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

1. Pipeline: Add skill to relevant stage if applicable

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

1. AGENTS.md: Add to available skills and update recommended sequences

1. 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

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: nicepkg
• Source: nicepkg/ai-workflow
• License: MIT
• Homepage: https://ai-workflow.xiaominglab.com/

Install and usage instructions live in the source repository linked above.