A skill that writes skills.
skill-creation is an Agent Skill: a folder with a SKILL.md file that
Claude Code, Codex, Cursor, OpenCode and other agents load on demand. This one teaches an agent to
write, review and install other skills — the naming rules, the description that decides whether a
skill ever triggers, the 500-line limit and how to split past it, and the install path for each
agent.
git clone https://github.com/<you>/skill-creation.git
cp -R skill-creation/.agents/skills/skill-creation ~/.agents/skills/~/.agents/skills/ serves Codex, Cursor and OpenCode in every project. Claude Code reads
~/.claude/skills/, so link it there as well:
ln -s ~/.agents/skills/skill-creation ~/.claude/skills/skill-creationFor one project only, use the project paths instead:
| Agent | Project path | Personal path |
|---|---|---|
| Codex | .agents/skills/ |
~/.agents/skills/ |
| Cursor | .agents/skills/, .cursor/skills/ |
~/.agents/skills/, ~/.cursor/skills/ |
| OpenCode | .opencode/skills/, .agents/skills/, .claude/skills/ |
~/.config/opencode/skills/, ~/.agents/skills/ |
| Claude Code | .claude/skills/ |
~/.claude/skills/ |
Restart the agent after you add a top-level skills directory that did not exist before.
Ask for a skill in your own words, and the agent loads this one:
- "Write a skill for our deploy procedure."
- "This skill never triggers — fix the description."
- "Turn the testing section of CLAUDE.md into a skill."
To force it, name it: "use the skill-creation skill". In Claude Code and Cursor, /skill-creation
invokes it directly.
.agents/skills/skill-creation/
├── SKILL.md # the procedure: gap → name → description → body → test → install
├── references/
│ └── frontmatter.md # every field, and where each one is valid
└── assets/
└── SKILL.template.md # skeleton for a new skill
The same shape works for any skill: SKILL.md holds the procedure, references/ holds detail the
agent reads on demand, scripts/ holds code it runs, and assets/ holds templates. Start with
SKILL.md alone, and add a folder only when the body passes 500 lines.
skills-ref validate .agents/skills/skill-creationskills-ref checks the
frontmatter and the naming rules. It cannot tell you whether the description triggers, so also run
the three trigger tests that SKILL.md describes.
The rules in this skill come from the Agent Skills specification, Anthropic's skill authoring best practices, and the skills documentation of Claude Code, Codex, Cursor and OpenCode.
MIT.