skill-creator

Create and validate Codex skill directories with templates and scripts.

5|1|Updated Jun 26, 2026
One-click install
npx skills add https://github.com/looooonk/better-codex --skill skill-creator-looooonk
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: skill-creator
Source: https://github.com/looooonk/better-codex/tree/main/codex-rs/skills/src/assets/samples/skill-creator
Command: npx skills add https://github.com/looooonk/better-codex --skill skill-creator-looooonk

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 frontmatter format, naming rules, resource organization, and validation requirements, which is easy to get wrong without guidance. ## Core Features & Use Cases - Skill Scaffolding: Generate a complete skill directory with a templated SKILL.md, agents/openai.yaml UI metadata, and optional scripts, references, and assets folders using init_skill.py. - Validation: Check frontmatter format, required fields, naming rules, and description constraints with quick_validate.py before publishing. - Authoring Guidance: Apply progressive disclosure principles, naming conventions, and a six-step creation workflow covering planning, initialization, editing, validation, and forward-testing. - 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 rotation script, write triggering instructions, and validate the result. ## Quick Start Use the skill-creator skill to create a new skill named pdf-editor in my Codex 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 init_skill.py with a skill name and output path to generate a directory containing a SKILL.md template and agents/openai.yaml. Then edit the frontmatter description, add instructions, and optionally include scripts, references, or assets folders.

What fields are required in SKILL.md frontmatter?▼

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

How do I validate a skill before publishing it?▼

Run quick_validate.py with the skill directory path. It checks YAML frontmatter format, required name and description fields, hyphen-case naming rules, and description length limits, reporting any issues to fix.

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

Add scripts for deterministic tasks rewritten repeatedly, references for documentation loaded into context as needed, and assets for files used in outputs like templates or fonts. Only create directories the skill actually requires.

What is the agents/openai.yaml file used for in a skill?▼

agents/openai.yaml stores UI-facing metadata such as display_name, short_description, icons, and a default_prompt. Generate it with generate_openai_yaml.py or init_skill.py by passing interface values as key=value arguments.