| name | skill-creator |
| description | Create new AI agent skills for Claude Code, Codex, and Cursor. Use when asked to create a skill, add a new agent capability, or set up a slash command. |
Skill Creator
Create AI agent skills that work across Claude Code, Codex, and Cursor.
Workflow
- Claude is canonical - Always create/edit in
.claude/skills/<name>/ first
- Replicate with CLI - Copy to
.codex/skills/ and .cursor/skills/ using cp -r
- Format differences - Use
sed only if agent-specific tweaks are needed (rare)
Directory Structure
.claude/skills/<skill-name>/
├── SKILL.md # Required - instructions + metadata
├── references/ # Optional - supporting documentation
├── scripts/ # Optional - executable helpers
└── assets/ # Optional - templates, resources
.codex/skills/<skill-name>/ # Copy of Claude's
.cursor/skills/<skill-name>/ # Copy of Claude's
SKILL.md Format
---
name: skill-name
description: What it does...
allowed-tools: Read, Grep, Bash
model: claude-opus-4-5-20251101
---
Instructions in markdown...
Required Fields
name: Lowercase with hyphens, must match directory name
description: Explains what the skill does and when to use it. Include keywords users would say to help the agent auto-select this skill.
Optional Fields (Claude-specific, ignored by other agents)
allowed-tools: Tools the agent can use without asking permission
model: Override the model for this skill
context: fork: Run in isolated subagent context
Creating a New Skill
- Ask the user what the skill should do
- Choose a descriptive name (lowercase, hyphens)
- Create the Claude skill:
mkdir -p .claude/skills/<name>
- Write
.claude/skills/<name>/SKILL.md with proper frontmatter
- Replicate to other agents:
cp -r .claude/skills/<name> .codex/skills/
cp -r .claude/skills/<name> .cursor/skills/
Modifying an Existing Skill
- Edit
.claude/skills/<name>/SKILL.md (canonical source)
- Replicate changes:
cp .claude/skills/<name>/SKILL.md .codex/skills/<name>/
cp .claude/skills/<name>/SKILL.md .cursor/skills/<name>/
Best Practices
- Keep skills focused on a single capability
- Write clear descriptions with keywords for auto-discovery
- Use
references/ for lengthy documentation to keep SKILL.md concise
- Test the skill by asking the agent to perform the task