skills.rest
cbusillo
cbusilloCOMMUNITY
Explore all skills by this author →
GitHub

skill-creator

Create, validate, and update Codex skill directories with scaffolding scripts and authoring guidance.

5|1|Updated May 5, 2026
Search Tags:#validation#scaffolding#codex#agent workflow#skill authoring#metadata generation#frontmatter
One-click install
npx skills add https://github.com/cbusillo/codex-skills --skill skill-creator-cbusillo
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: skill-creator
Source: https://github.com/cbusillo/codex-skills/tree/main/skills/skill-creator
Command: npx skills add https://github.com/cbusillo/codex-skills --skill skill-creator-cbusillo

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? Writing a well-structured agent skill requires knowing frontmatter rules, naming conventions, resource organization, and validation contracts; this Skill guides the full creation and update workflow so new skills trigger correctly and stay maintainable. ## Core Features & Use Cases - Skill Scaffolding: Run init_skill.py to generate a new skill directory with a SKILL.md template, agents/openai.yaml UI metadata, and optional scripts, references, and assets folders. - Validation Tooling: Use quick_validate.py for single-skill checks and repo-level validators for catalog-wide structure, command policies, and behavior smoke tests. - Authoring Guidance: Apply built-in principles for concise instructions, progressive disclosure, outcome-first contracts, and forward-testing with subagents. - Use Case: When asked to build a new skill for a recurring workflow, scaffold it with init_skill.py, write the SKILL.md body following the design principles, generate UI metadata, and validate before shipping. ## Quick Start Use the skill-creator skill to scaffold and validate a new skill named pdf-reporter in my skills directory.

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 the skill name and output path to scaffold a directory containing a SKILL.md template and agents/openai.yaml. Then edit the frontmatter description and body, add any needed scripts or references, and validate with quick_validate.py.

How to validate a skill folder before publishing it?▼

Run quick_validate.py against the skill folder to check frontmatter, naming, command policies, and structured metadata. For repository-wide checks across all active skills, use the validate-skill-repo.py script.

What files does a valid skill directory require?▼

A skill requires a SKILL.md file with YAML frontmatter containing name and description, followed by Markdown instructions. Optional scripts, references, and assets directories hold supporting resources, and agents/openai.yaml provides UI metadata.

Does the skill description field affect when a skill triggers?▼

Yes, the description is the primary triggering mechanism and must include both what the skill does and when to use it. Trigger information placed only in the body is ineffective because the body loads only after the skill activates.

When should I not add scripts or references to a skill?▼

Only create resource directories the skill actually needs; placeholder or unused files add clutter. Use scripts for deterministic repeated work, references for details loaded on demand, and assets for files used in final output.

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
vinhnguyenn020325-cmdvinhnguyenn020325-cmd

benchmark-testing

Create and execute benchmark test projects for vercel-plugin skill injection.

Community
Intermediate
ThalesGroupThalesGroup
19

agilab-prompt-eval-regression

Convert AGILAB prompts and model responses into repeatable regression fixtures.

Official
Advanced
rizaldiemrizaldiem

template-skill

Scaffold Skill Unit directories with a minimal SKILL.md template.

Community
Basic