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:
   bash

   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>