codex-skill-generator

Codex Skill Generator

Create focused Codex skills that trigger reliably, stay small, and encode reusable judgment instead of generic prose.

When to Activate

• Create a new skill for this repo
• Refactor a large guidance document into a skill
• Tighten a weak description so the skill triggers correctly
• Convert AGENTS-style guidance into skills/<name>/SKILL.md
• Review an existing skill for format drift
• Add examples, tables, or a checklist to a thin skill
• Update the README inventory after adding a skill

Build Order

Step	Do
1	Pick one narrow domain with clear activation triggers
2	Write a dense description that says what the skill does, when to use it, AND when NOT to use it
3	Add 6-8 verb-led items under ## When to Activate
4	Organize the body around decisions, examples, and checklists
5	End with a shipping-oriented checklist
6	Update the repo inventory and validation surface

Required Format

---
name: kebab-case-name
description: Dense sentence that says what the skill does, when to use it, AND when NOT to use it (scope boundary). Codex uses this for implicit activation matching.
---

# Title

One-sentence summary.

## When to Activate
- Verb-led trigger

## Content Sections

## Checklist
- [ ] Shipping check

Rules:

• Folder name must match name.
• Frontmatter must contain only name and description.
• Put activation hints AND scope boundaries in description; that is what Codex matches against for implicit invocation.
• Include at least one decision or comparison table.
• Include at least one BAD / GOOD pair.
• Keep the body terse and directly operational.
• Optionally add agents/openai.yaml to the skill folder to set interface metadata, policy.allow_implicit_invocation, and dependencies.tools (e.g. required MCP servers).

What Good Skills Contain

Include	Why
Trigger language in description	Helps the skill load at the right time
Decision tables	Compress tradeoffs without bloating prose
Realistic code or command examples	Makes the guidance executable
A checklist	Gives Codex a final pass before finishing