By 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
- Always edit Claude first -
.claude/skills/<name>/SKILL.mdis the canonical source - Replicate with CLI - Copy changes to
.codex/skills/and.cursor/skills/ - 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
- Read the current skill content from
.claude/skills/<name>/SKILL.md - Make the requested changes
- 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>