Remove Old Skills From Workflow
- 263 installs
- 275 repo stars
- Updated January 20, 2026
- nicepkg/ai-workflow
remove-old-skills-from-workflow is an agent skill that deletes deprecated skill directories and updates seven workflow documentation files without orphaned references for developers maintaining nicepkg ai-workflow bundle
About
remove-old-skills-from-workflow is a nicepkg/ai-workflow maintenance skill with a four-step removal workflow: grep for skill references, delete the .claude/skills/skill-name folder, update skill-source.json when present, and audit seven documentation files. Required updates span workflows/<name>/README.md, README_cn.md, AGENTS.md, website/content/en and zh workflow MDX pages, and root README.md plus README_cn.md skill counts, tables, pipeline stages, and combination chains. The skill decrements total skill counts, removes table rows, fixes pipeline diagrams, and updates example workflows that referenced the deleted skill. Use remove-old-skills-from-workflow when deprecating a skill from an ai-workflow bundle and documentation drift must be avoided.
- 4-step removal: grep references, rm -rf skill folder, edit skill-source.json, update docs
- Mandates updates across 7 documentation files including EN/ZH README and MDX
- Checklist covers skill counts, tables, pipeline stages, and combination chains
- Pairs with add-new-skills-to-workflow in the 170+ skill ai-workflow repo
- Install via npx skills add nicepkg/ai-workflow --skill remove-old-skills-from-workflow
Remove Old Skills From Workflow by the numbers
- 263 all-time installs (skills.sh)
- +3 installs in the week ending Jul 26, 2026 (Skillselion tracking)
- Ranked #158 of 779 Skill Development skills by installs in the Skillselion catalog
- Data as of Aug 4, 2026 (Skillselion catalog sync)
npx skills add https://github.com/nicepkg/ai-workflow --skill remove-old-skills-from-workflowAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 263 |
|---|---|
| repo stars | ★ 275 |
| Last updated | January 20, 2026 |
| Repository | nicepkg/ai-workflow ↗ |
How do you remove a skill from an ai-workflow?
Follow remove-old-skills-from-workflow to delete a deprecated skill folder and update all seven workflow documentation files without orphaned references.
Who is it for?
Developers maintaining nicepkg ai-workflow repositories who need a checklist-driven skill removal without broken references in bilingual docs and website MDX.
Skip if: One-off SKILL.md files outside ai-workflow bundles that do not ship seven linked README, AGENTS.md, and website documentation files.
When should I use this skill?
A user says remove skill, delete skill, or needs to deprecate a skill from an ai-workflow while updating skill counts and documentation tables.
What you get
Deleted skill directory, updated skill-source.json entry, revised seven documentation files with corrected skill counts, tables, pipelines, and example workflows.
- Cleaned skill directory tree
- Updated seven documentation files
- Revised skill-source.json
By the numbers
- Updates seven documentation files after each skill removal
- Follows a four-step removal workflow from grep through documentation audit
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)
| 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 tableImportant 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.mdunchanged (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
Related skills
Find SkillsSo their agent can intelligently recommend and install the right modular skills from the open ecosystem when they ask how to do something.3M27.9k
Lark Skill MakerRapidly create custom skills for Lark (Feishu) that can be invoked by their AI agents and automation workflows.513k
Skill CreatorGenerate, test, and iterate on new reusable agent skills directly inside their Claude or Cursor workflow.337k166k
BrainstormingTurn vague product ideas into clear, approved designs and specifications through guided collaborative dialogue before writing any code.307k265k
Writing Great SkillsCreate high-quality, reusable agent skills that other developers can discover and install from the Skillselion catalog.290k200k
Find SkillsInstantly surface the best relevant agent skills, MCP servers, and workflows across multiple registries before starting any new project.226k12How it compares
Pick remove-old-skills-from-workflow over generic delete instructions when maintaining nicepkg ai-workflow repos with bilingual README, AGENTS.md, and website MDX sync requirements.
FAQ
How many files does remove-old-skills-from-workflow update?
remove-old-skills-from-workflow requires updating seven documentation files: workflow README.md, README_cn.md, AGENTS.md, English and Chinese website MDX pages, and root README.md plus README_cn.md skill count tables.
What is the removal order in remove-old-skills-from-workflow?
remove-old-skills-from-workflow starts with grep to find references, deletes the .claude/skills/skill-name directory, updates skill-source.json if it exists, then audits all seven documentation files for counts, tables, and pipeline references.
Does remove-old-skills-from-workflow change references/skill-sources.md?
remove-old-skills-from-workflow leaves references/skill-sources.md unchanged because that file documents ecosystem-wide skills rather than workflow-specific installations removed from a single bundle.