/skill-editor

name: skill-editor
description: REQUIRED for editing any skill file. Ensures changes sync to Claude, Codex, and Cursor. Never edit .claude/skills/ files directly - always use this skill.

Skill Editor

Edit existing AI agent skills while keeping Claude, Codex, and Cursor in sync.

Workflow

1. **Always edit Claude first** - `.claude/skills/<name>/SKILL.md` is the canonical source 2. **Replicate with CLI** - Copy changes to `.codex/skills/` and `.cursor/skills/` 3. **Never edit Codex/Cursor directly** - They are copies of Claude's version

Finding Existing Skills

List all skills:

ls -la .claude/skills/

Read a skill:

cat .claude/skills/<name>/SKILL.md

Editing a Skill

1. Read the current skill content from `.claude/skills/<name>/SKILL.md` 2. Make the requested changes 3. Replicate to other agents:

   cp .claude/skills/<name>/SKILL.md .codex/skills/<name>/
   cp .claude/skills/<name>/SKILL.md .cursor/skills/<name>/

Verification

Always verify sync after editing:

diff .claude/skills/<name>/SKILL.md .codex/skills/<name>/SKILL.md
diff .claude/skills/<name>/SKILL.md .cursor/skills/<name>/SKILL.md

No output means files are identical.

Common Edits

• **Update description** - Improve auto-discovery keywords
• **Add instructions** - Expand the skill's capabilities
• **Fix errors** - Correct mistakes in the skill logic
• **Add references** - Create `references/` directory for supporting docs

Deleting a Skill

Remove from all three locations:

rm -rf .claude/skills/<name> .codex/skills/<name> .cursor/skills/<name>