| name | remove-old-skills-from-workflow |
| description | Guide for removing skills from an existing workflow and updating all related documentation. Use when user wants to remove skills from a workflow (e.g., "remove skill", "delete skill", "移除技能", "删除技能"). |
Remove Skills from Workflow
Guide for removing skills from an existing workflow and updating all related documentation.
When to Use
- User wants to remove a skill from a workflow
- User says "remove skill", "delete skill", "移除技能", "删除技能"
- Cleaning up unused or deprecated skills from a workflow
Removal Workflow
Step 1: Identify the Skill
Search for the skill name across the workflow to understand its usage:
grep -r "skill-name" /path/to/workflow/
Step 2: Delete Skill Folder
Remove the skill directory from the workflow:
rm -rf /path/to/workflow/.claude/skills/skill-name/
Step 3: Update skill-source.json (if exists)
Remove the skill entry from /path/to/workflow/.claude/skill-source.json
Step 4: Update All Related Documentation
After removing a skill, you MUST update these files:
Files to Update (7 files)
| File | What to Update |
|---|
workflows/<workflow-name>/README.md | Skill count, skill table, pipeline stages, skill combinations |
workflows/<workflow-name>/README_cn.md | Same as above (Chinese version) |
workflows/<workflow-name>/AGENTS.md | Available skills list, recommended sequences |
website/content/en/workflows/<workflow>.mdx | Skill count, skill table, pipeline, skill combinations |
website/content/zh/workflows/<workflow>.mdx | Same as above (Chinese version) |
README.md (root) | Workflow table skill count |
README_cn.md (root) | Workflow table skill count (Chinese version) |
Documentation Update Checklist
For each documentation file, update:
Example
Removing ppt-creator skill from talk-to-slidev-workflow:
grep -r "ppt-creator" workflows/talk-to-slidev-workflow/
rm -rf workflows/talk-to-slidev-workflow/.claude/skills/ppt-creator/
Important Notes
- Always search for skill references before removal to understand impact
- The root READMEs only need skill count updates in the workflow table
- Leave
references/skill-sources.md unchanged (it documents ecosystem skills, not workflow-specific installations)
- If the skill is referenced in example workflows, either remove the example or update it to use alternative skills