skill-creator

Create and validate Codex skill directories with templates, scripts, and frontmatter rules.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/chhpt/skills --skill skill-creator-chhpt
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-creator
Source: https://github.com/chhpt/skills/tree/main/skills/skill-creator__codex
Command: npx skills add https://github.com/chhpt/skills --skill skill-creator-chhpt

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? Creating a well-structured skill for Codex requires knowing the SKILL.md format, frontmatter rules, naming conventions, and resource organization, which is easy to get wrong without guidance. ## Core Features & Use Cases - Skill Scaffolding: Run init_skill.py to generate a complete skill directory with a SKILL.md template, agents/openai.yaml UI metadata, and optional scripts, references, and assets folders. - Validation: Run quick_validate.py to check YAML frontmatter, required fields, naming rules, and description constraints before publishing. - Authoring Guidance: Follow built-in principles for concise instructions, progressive disclosure, and forward-testing with subagents. - Use Case: When you want to teach Codex a repeatable workflow like rotating PDFs, use this skill to scaffold a pdf-editor skill, add a rotate script, write triggering descriptions, and validate the result. ## Quick Start Use the skill-creator skill to create a new skill named pdf-editor in my skills directory with a scripts folder.

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 from scratch?

Run scripts/init_skill.py with the skill name and output path, optionally passing --resources scripts,references,assets and --examples. It generates the skill directory, a SKILL.md template, and agents/openai.yaml, which you then edit and validate.

What fields are required in SKILL.md frontmatter?

SKILL.md frontmatter requires only name and description. The name must be lowercase hyphen-case under 64 characters, and the description must explain what the skill does and when to trigger it, without angle brackets.

How do I validate a skill folder before publishing?

Run scripts/quick_validate.py with the path to the skill folder. It checks frontmatter format, required fields, naming rules, and description length, printing whether the skill is valid or listing the issues to fix.

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 is agents/openai.yaml used for in a skill?

agents/openai.yaml holds UI-facing metadata such as display_name, short_description, icons, and default_prompt shown in skill lists and chips. Generate it with generate_openai_yaml.py or init_skill.py using --interface key=value overrides.