Skill Creator

Use when creating, updating, validating, or packaging Codex skills, including writing SKILL.md files, choosing concise trigger descriptions, adding agents/openai.yaml metadata, and preparing skill folders for local or GitHub deployment.

cxijin6-cell Updated

File contents

Skill Creator

Use this skill to create compact, usable Codex skills.

Required Structure

Every skill folder must include:

  • SKILL.md
  • YAML frontmatter with only name and description
  • Clear instructions in the body

Recommended UI metadata:

  • agents/openai.yaml
  • display_name
  • short_description
  • default_prompt

Workflow

  1. Normalize the skill name to lowercase hyphen-case.
  2. Write a trigger-focused description that says when to use the skill.
  3. Keep the body concise and procedural.
  4. Add scripts, references, or assets only when they directly support repeated use.
  5. Validate that every required file exists and the name matches the folder.

Quality Bar

  • Do not add extra README-style documentation unless the user asks.
  • Keep instructions useful for another Codex instance, not for a human installation guide.
  • Prefer reusable scripts for fragile repeatable operations.
  • Keep references one level away from SKILL.md and load them only when needed.

cxijin6-cell/codex-skills/tree/main/skills/skill-creator commit c3b44b7c56

Frequently asked questions

npx skillmds@latest add cxijin6-cell/skill-creator