Remove Old Skills From Workflow

This walks you through cleanly removing a skill from a Claude workflow without leaving orphaned references everywhere. It's surprisingly thorough: you get a checklist for updating seven different documentation files (English and Chinese versions of READMEs, agent docs, and website content), plus the actual deletion commands and skill-source.json updates. The real value is in the documentation audit, it makes sure you update skill counts, remove table rows, fix pipeline diagrams, and clean up any example workflows that referenced the deleted skill. Nice that it includes multilingual support and catches the easy-to-miss root README updates. Solid maintenance automation for keeping workflows tidy.

skills.sh installs: 283
GitHub stars: 291
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add nicepkg/ai-workflow --skill remove-old-skills-from-workflow --agent claude-code

Installs into .claude/skills of the current project.

Files

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)

SKILL.md on GitHub

Details

Repository: github.com/nicepkg/ai-workflow
Categories: Documentation, AI & Agent Building, Automation & Workflows
First seen: Jun 3, 2026