skill-creator

Create and validate Codex skill directories with scoped instructions and supporting resources.

Updated Jul 22, 2026
One-click install
npx skills add https://github.com/Chau165/local_skill --skill skill-creator-chau165
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-creator
Source: https://github.com/Chau165/local_skill/tree/main/codex/skills/.system/skill-creator
Command: npx skills add https://github.com/Chau165/local_skill --skill skill-creator-chau165

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 requires knowing the SKILL.md frontmatter rules, naming conventions, progressive disclosure patterns, and validation requirements, which are easy to get wrong without guidance. ## Core Features & Use Cases - Skill Scaffolding: Initialize a new skill directory with a SKILL.md template, agents/openai.yaml UI metadata, and optional scripts, references, and assets folders via init_skill.py. - Authoring Guidance: Apply core principles for scoped instructions, discriminating descriptions, and progressive disclosure across entrypoint and reference files. - Validation: Check frontmatter, naming rules, and unfinished TODO placeholders with quick_validate.py before publishing a skill. - Use Case: When you want to package a repeatable workflow as a reusable Codex skill, use this Skill to scaffold the folder, write the instructions, generate UI metadata, and validate the result. ## Quick Start Use the skill-creator skill to create a new skill named pdf-rotator in my skills directory with a scripts folder and validate it.

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 scripts/init_skill.py with the skill name and output path to scaffold the directory, SKILL.md template, and agents/openai.yaml. Then edit SKILL.md to replace the TODO placeholders and validate with scripts/quick_validate.py.

What is required in a SKILL.md file?

SKILL.md must contain YAML frontmatter with a name and description, followed by a Markdown body with the operational instructions. The name must be lowercase hyphen-case under 64 characters, and the description cannot contain angle brackets or exceed 1024 characters.

When should a skill use scripts, references, or assets folders?

Use scripts for deterministic repeated automation, references for documentation needed only in specific contexts, and assets for files copied into generated output like templates or fonts. Create these directories only when the workflow concretely benefits from them.

How do I make a skill explicit-only instead of automatically selected?

Set policy.allow_implicit_invocation to false in agents/openai.yaml. The skill then stays out of the model context by default but can still be invoked explicitly via $skill-name.

Why does skill validation fail on my SKILL.md?

Validation fails when frontmatter is missing name or description, the name violates hyphen-case rules, the description contains TODO placeholders or angle brackets, or unexpected frontmatter keys are present. Run quick_validate.py to see the specific error.