skill-creator

skill creator

openai 24k ↓ 2.8k updated 1mo ago
Claude Code
View source ↗

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

Source

Repository: https://github.com/openai/skills

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.