| 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.md is 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>