Individual skill
create-skill
Create a new skill or update an existing skill that extends Codex's capabilities with specialized knowledge, workflows, or tool integrations. Use when the user asks to "create a skill", "make a new skill", "build a skill", "scaffold a skill", "write a skill for...", or "new skill that does...".
codex/skills/create-skill/SKILL.md
Source commit d56f17f0ba88ead3a4a77fcdc884f80cd3d10d2f
What was checked
- Matches the observed repository HEAD
- Yes
- Scanner rules are current
- Yes
- Repository scan complete
- No
- Skill scan complete
- Yes
- Observed behavior
- Instructions only
- Last checked
- Nov 10, 2026
These are observations at the recorded commit, not a guarantee of safety. Review the source before running it.
Install this skill
Choose an agent in your Stack or copy a command below. Commands fetch the pinned commit and copy only this skill directory. Existing destinations are refused. Copying a command does not install anything.
An install command is unavailable: current rules, complete repository and skill scans, an eligible behavior level and a permitted license are required.
Repository context
- Repository stars (not skill ratings)
- 420
- Repository last updated
- Nov 9, 2026
- License
- MIT
Observed agent integration: No specific integration evidence. Standard SKILL.md installation does not imply verified compatibility.
- agent-skills Repository topic
- claude-code Repository topic
- claude-skills Repository topic
- developer-tools Repository topic
- skills Repository topic
- codex Repository topic
- codex-skills Repository topic
- agentic-coding Repository topic
- claude-code-plugin Repository topic
- codex-plugin Repository topic
- engineering Derived category
Files and excerpt
File metadata and permitted, redacted excerpts come from the recorded scan. Source links are pinned to that commit.
Browse files
SKILL.mdcore · 10,193 bytesreferences/composition.mddoc · 4,775 bytesreferences/evaluation.mddoc · 4,071 bytesreferences/harness.mddoc · 3,907 bytesreferences/principles.mddoc · 6,731 bytesreferences/scripts.mddoc · 4,657 bytesreferences/skill-reviewer.mddoc · 5,246 bytesreferences/structure.mddoc · 8,633 bytesreferences/tools.mddoc · 23,027 bytesreferences/workflows.mddoc · 7,709 bytesreferences/writing.mddoc · 7,451 bytes
Read excerpt
# Create Skill
This skill guides the creation of effective skills. Authoring guidance is split across the reference files below. Read the ones the current step needs rather than all of them.
| Reference | Covers |
|---|---|
| [references/principles.md](references/principles.md) | Conciseness, instructions-not-documentation, degrees of freedom |
| [references/structure.md](references/structure.md) | Frontmatter, naming, descriptions, progressive disclosure, file layout |
| [references/writing.md](references/writing.md) | Prose rules: terminology, phrasing, conditions, thresholds |
| [references/workflows.md](references/workflows.md) | Step/phase structure, feedback loops, exit signals, output patterns |
| [references/composition.md](references/composition.md) | Depending on, invoking, and fanning out to other skills |
| [references/tools.md](references/tools.md) | `spawn_agent`, `request_user_input`, and MCP tool invocation |
| [references/evaluation.md](references/evaluation.md) | Evaluations and iterating on a skill from observed behavior |
| [references/scripts.md](references/scripts.md) | Skills that bundle executable code |