add-new-skills-to-workflow
npx machina-cli add skill nicepkg/ai-workflow/add-new-skills-to-workflow --openclawAdd 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/skillhttps://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
Source
git clone https://github.com/nicepkg/ai-workflow/blob/main/.claude/skills/add-new-skills-to-workflow/SKILL.mdView on GitHub Overview
Add skills from GitHub to an existing workflow and refresh all related documentation. This ensures new capabilities are incorporated and documented across sources like skill-source.json, READMEs, AGENTS.md, and website content.
How This Skill Works
Download the skills from GitHub using the skill-downloader to pull the new skill assets into the workflow. Read the downloaded SKILL.md to understand the skill, then update skill-source.json and all related documentation.
When to Use It
- You want to add a new Skill from a GitHub URL to an existing workflow.
- You need to register the new skill source in skill-source.json.
- You must update all related workflow documentation after adding a skill.
- You are batching multiple new skills into the same workflow.
- You want to standardize skill counts and tables across root and site docs.
Quick Start
- Step 1: Download skills from GitHub using the download_from_github.py script.
- Step 2: Read the downloaded SKILL.md to understand the skill's purpose and fit.
- Step 3: Update workflows/<name>/.claude/skill-source.json and all related documentation as outlined.
Best Practices
- Verify the GitHub URL and skill-path before downloading.
- Back up the current workflow and docs before applying changes.
- Validate the downloaded SKILL.md matches the expected structure and content.
- Use the provided JSON snippet in skill-source.json to record the source.
- Update all affected docs (skill table, pipeline, AGENTS.md, and website pages) and adjust the skill count.
Example Use Cases
- Add slidev from XIYO/zheon to talk-to-slidev-workflow and update all docs.
- Add slidev-presentations from clearfunction/cf-devtools to the same workflow and refresh documentation.
- Add a new language-translation skill to a multilingual-workflow and update READMEs.
- Add an image-generation skill to a design workflow and update AGENTS.md.
- Add a data-cleaning skill to a data-pipeline-workflow and adjust the root README.
