remove-old-skills-from-workflow

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

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
  • 用户想要从工作流中移除某个技能
  • 用户提及"remove skill"、"delete skill"、"移除技能"、"删除技能"
  • 清理工作流中未使用或已弃用的技能

Removal Workflow

移除流程

Step 1: Identify the Skill

步骤1:定位技能

Search for the skill name across the workflow to understand its usage:
bash
undefined
在整个工作流中搜索技能名称,以了解其使用情况:
bash
undefined

Find all references to the skill

查找该技能的所有引用

grep -r "skill-name" /path/to/workflow/
undefined
grep -r "skill-name" /path/to/workflow/
undefined

Step 2: Delete Skill Folder

步骤2:删除技能文件夹

Remove the skill directory from the workflow:
bash
rm -rf /path/to/workflow/.claude/skills/skill-name/
从工作流中移除技能目录:
bash
rm -rf /path/to/workflow/.claude/skills/skill-name/

Step 3: Update skill-source.json (if exists)

步骤3:更新skill-source.json(若存在)

Remove the skill entry from
/path/to/workflow/.claude/skill-source.json
/path/to/workflow/.claude/skill-source.json
中移除该技能的条目

Step 4: Update All Related Documentation

步骤4:更新所有相关文档

After removing a skill, you MUST update these files:
移除技能后,你必须更新以下文件:

Files to Update (7 files)

需要更新的文件(共7个)

FileWhat 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)
文件更新内容
workflows/<workflow-name>/README.md
技能数量、技能表格、流水线阶段、技能组合
workflows/<workflow-name>/README_cn.md
与上述内容一致(中文版本)
workflows/<workflow-name>/AGENTS.md
可用技能列表、推荐序列
website/content/en/workflows/<workflow>.mdx
技能数量、技能表格、流水线、技能组合
website/content/zh/workflows/<workflow>.mdx
与上述内容一致(中文版本)
README.md
(根目录)
工作流表格中的技能数量
README_cn.md
(根目录)
工作流表格中的技能数量(中文版本)

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
对于每个文档文件,需更新:
  • 技能数量:减少总技能数(例如:“20个技能” → “19个技能”)
  • 技能表格:从任何技能列表表格中移除该技能的行
  • 流水线/阶段:从流水线图或阶段描述中移除技能引用
  • 技能组合:移除包含已删除技能的任何技能链
  • 示例工作流:移除或更新引用该技能的示例

Example

示例

Removing
ppt-creator
skill from
talk-to-slidev-workflow
:
bash
undefined
talk-to-slidev-workflow
中移除
ppt-creator
技能:
bash
undefined

1. Search for references

1. 搜索引用

grep -r "ppt-creator" workflows/talk-to-slidev-workflow/
grep -r "ppt-creator" workflows/talk-to-slidev-workflow/

2. Delete skill folder

2. 删除技能文件夹

rm -rf workflows/talk-to-slidev-workflow/.claude/skills/ppt-creator/
rm -rf workflows/talk-to-slidev-workflow/.claude/skills/ppt-creator/

3. Update skill-source.json

3. 更新skill-source.json

Remove the ppt-creator entry

移除ppt-creator条目

4. Update documentation files

4. 更新文档文件

- Update skill count from 20 to 19

- 将技能数量从20更新为19

- Remove ppt-creator from skill tables

- 从技能表格中移除ppt-creator

- Remove from pipeline Stage 6

- 从流水线第6阶段中移除

- Remove from skill combinations table

- 从技能组合表格中移除

undefined
undefined

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
  • 移除前务必搜索技能引用,以了解影响范围
  • 根目录的README仅需更新工作流表格中的技能数量
  • 请勿修改
    references/skill-sources.md
    (该文件记录生态系统技能,而非工作流特定安装的技能)
  • 如果技能在示例工作流中被引用,请移除该示例或更新为使用替代技能