skills.rest
xlnn
xlnnCOMMUNITY
Explore all skills by this author →
GitHub

skill-creator

Create and validate Codex skill directories with templates and scripts.

1|Updated Aug 1, 2026
Search Tags:#workflow#template#validation#scaffolding#codex#skill#frontmatter
One-click install
npx skills add https://github.com/xlnn/modelmux-vscode --skill skill-creator-xlnn
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: skill-creator
Source: https://github.com/xlnn/modelmux-vscode/tree/main/.tmp-codex-home4/skills/.system/skill-creator
Command: npx skills add https://github.com/xlnn/modelmux-vscode --skill skill-creator-xlnn

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pyyaml, and includes scripts (resource) and references (resource) components.

What problem does it solve? Writing a well-structured Codex skill from scratch is error-prone: frontmatter rules, naming conventions, directory layout, and UI metadata are easy to get wrong. This Skill guides the full lifecycle of creating or updating skills so they trigger correctly and stay concise. ## Core Features & Use Cases - Guided Creation Workflow: Six-step process covering understanding use cases, planning resources, initialization, editing, validation, and iteration. - Scaffolding Scripts: init_skill.py generates a complete skill directory with SKILL.md template, agents/openai.yaml, and optional scripts/references/assets folders. - Validation & UI Metadata: quick_validate.py checks frontmatter and naming rules; generate_openai_yaml.py produces display metadata for skill lists. - Use Case: When you want to teach Codex a repeatable workflow—like processing a proprietary file format—use this Skill to scaffold, document, and validate a new skill folder that Codex auto-discovers. ## Quick Start Use the skill-creator skill to create a new skill named pdf-reporter in my Codex skills directory with scripts and references resources.

Frequently Asked Questions about skill-creator

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a new Codex skill?▼

Run init_skill.py with the skill name and output path to scaffold a directory containing a SKILL.md template and agents/openai.yaml. Then edit the frontmatter description, write the body instructions, and validate with quick_validate.py.

What should go in a SKILL.md description field?▼

The description must state what the skill does and exactly when to use it, including specific trigger scenarios, file types, or tasks. It is the primary triggering mechanism, so all when-to-use information belongs there, not in the body.

When should a skill include scripts, references, or assets?▼

Add scripts for deterministic or repeatedly rewritten code, references for documentation loaded into context on demand, and assets for files used in outputs like templates or fonts. Only create directories the skill actually needs.

What naming rules apply to Codex skills?▼

Skill names must be lowercase hyphen-case using only letters, digits, and hyphens, with a maximum of 64 characters. Names cannot start or end with a hyphen or contain consecutive hyphens, and the folder must match the name.

Why does skill validation fail on frontmatter?▼

Validation fails when the YAML frontmatter is missing name or description, contains unexpected keys, or the description includes angle brackets or exceeds 1024 characters. Run quick_validate.py to see the exact reported issue.

Related Skills

Explore More Software Engineering Skills→
microclawmicroclaw
731

skill-creator

Guides creation of skills with YAML frontmatter, SKILL.md structure, and bundled resources.

Official
Intermediate
luicabref97luicabref97

customaize-agent:test-prompt

Validate prompts with RED-GREEN-REFACTOR cycles using isolated subagents.

Community
Intermediate
moralucomoraluco

sync-rules-and-skills

Consolidate overlapping Cursor rule and SKILL.md content into authoritative files.

Community
Intermediate
liuaibin001liuaibin001

writing-skills

Create SKILL.md files with YAML frontmatter and reference file organization.

Community
Intermediate