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>