skill-creator
skill creator
What it does
- Body (Markdown): Instructions and guidance for using the skill. Only loaded AFTER the skill triggers (if at all).
- UI-facing metadata for skill lists and chips
- Read references/openaiyaml.md before generating values and follow its descriptions and constraints
- Create: human-facing displayname, shortdescription, and defaultprompt by reading the skill
- Generate deterministically by passing the values as --interface key=value to scripts/generateopenaiyaml.py or scripts/initskill.py
- On updates: validate agents/openai.yaml still matches SKILL.md; regenerate if stale
- Only include other optional interface fields (icons, brand color) if explicitly provided
Requirements & configuration
- The context window is a public good. Skills share the context window with everything else Codex needs: system prompt, conversation history, other Skills' metadata, and the actual user request.
- Think of Codex as exploring a path: a narrow bridge with cliffs needs specific guardrails (low freedom), while an open field allows many routes (high freedom).
- Executable code (Python/Bash/etc.) for tasks that require deterministic reliability or are repeatedly rewritten.
- Benefits: Token efficient, deterministic, may be executed without loading into context
- Note: Scripts may still need to be read by Codex for patching or environment-specific adjustments
Derived from the skill's own SKILL.md documentation · extracted 2026-07-23
skill-creator FAQ
What does the skill-creator skill do?
Guide for creating effective skills. This skill should be used when users want to create a new skill (or update an existing skill) that extends Codex's capabilities with specialized knowledge, workflows, or tool integrations. Body (Markdown): Instructions and guidance for using the skill. Only loaded AFTER the skill triggers (if at all). UI-facing metadata for skill lists and chips
What does skill-creator require?
The context window is a public good. Skills share the context window with everything else Codex needs: system prompt, conversation history, other Skills' metadata, and the actual user request. Think of Codex as exploring a path: a narrow bridge with cliffs needs specific guardrails (low freedom), while an open field allows many routes (high freedom). Executable code (Python/Bash/etc.) for tasks that require deterministic reliability or are repeatedly rewritten. Benefits: Token efficient, deterministic, may be executed without loading into context Note: Scripts may still need to be read by Codex for patching or environment-specific adjustments
How do I install skill-creator?
Run: npx -y skills add https://github.com/openai/skills --skill skill-creator --agent claude-code — the source lives at github.com/openai/skills.
Maintain skill-creator?
Let people know it's listed here — add the badge (live metrics, light/dark aware) or a plain link to your README or docs.
[skill-creator on getagentictools](https://getagentictools.com/skills/openai-skills-skill-creator?ref=badge) npx agentictools info skills/openai-skills-skill-creator The second line is the CLI lookup for this page — handy in READMEs and docs.