Remove Old Skills From Workflow

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:

# Find all references to the skill
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:

• [ ] Skill count: Decrease the total skill count (e.g., "20 skills" → "19 skills")
• [ ] Skill tables: Remove the skill row from any skill listing tables
• [ ] Pipeline/stages: Remove skill references from pipeline diagrams or stage descriptions
• [ ] Skill combinations: Remove any skill chains that include the removed skill
• [ ] Example workflows: Remove or update examples that reference the skill

Example

Removing ppt-creator skill from talk-to-slidev-workflow:

# 1. Search for references
grep -r "ppt-creator" workflows/talk-to-slidev-workflow/

# 2. Delete skill folder
rm -rf workflows/talk-to-slidev-workflow/.claude/skills/ppt-creator/

# 3. Update skill-source.json
# Remove the ppt-creator entry

# 4. Update documentation files
# - Update skill count from 20 to 19
# - Remove ppt-creator from skill tables
# - Remove from pipeline Stage 6
# - Remove from skill combinations table

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