Skill Builder

Scaffold Codex Skill definitions with YAML frontmatter and progressive disclosure structure.

3|Updated Mar 7, 2026

Search Tags:#automation #templates #codex #yaml #skill #frontmatter #progressive-disclosure

Ready to run

npx skills add https://github.com/nidhi-subrah/HackCanada2026 --skill skill-builder-nidhi-subrah

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: Skill Builder
Source: https://github.com/nidhi-subrah/HackCanada2026/tree/main/.agents/skills/skill-builder
Command: npx skills add https://github.com/nidhi-subrah/HackCanada2026 --skill skill-builder-nidhi-subrah

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The Skill Builder standardizes how new Codex Skills are created by enforcing a consistent YAML frontmatter, progressive disclosure structure, and clean directory layout to enable reliable discovery and scalable skill development.

Core Features & Use Cases

Enforces a two-field frontmatter (name and description) in SKILL.md to enable discovery and onboarding.
Guides the creation of a four-level skill structure (Level 1 metadata, Level 2 body, Level 3 references, and Level 4 troubleshooting/docs) for scalable documentation.
Provides templates and best practices for organizing optional scripts/, references/, and assets/ to support on-demand loading and reusability.

Quick Start

Create a new skill directory at your Codex skills location, add SKILL.md with proper frontmatter, and populate any optional resources (scripts/, references/, assets/) as needed.

Frequently Asked Questions about Skill Builder

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

FAQPage Schema

How do I scaffold a production-ready Codex Skill with YAML frontmatter?▼

To scaffold a production-ready Codex Skill, create a skill directory, add a SKILL.md file with two-field YAML frontmatter (name and description), and populate optional scripts/, references/, and assets/ folders for on-demand loading. This enforces a clean directory layout for reliable discovery.

What is the progressive disclosure structure for Codex Skills?▼

Progressive disclosure in Codex Skills organizes content into four levels: Level 1 metadata in YAML frontmatter, Level 2 body documentation, Level 3 references, and Level 4 troubleshooting or docs. This structure enables scalable documentation and on-demand loading of resources.

How do I organize scripts and references when creating a new Codex Skill?▼

Organize scripts and references by creating optional scripts/, references/, and assets/ directories within your skill folder. This layout supports on-demand loading and reusability, keeping the core SKILL.md metadata clean while maintaining accessible supporting resources.

Do I need any dependencies to build a Codex Skill definition?▼

No dependencies are required to build a Codex Skill definition. You only need to create a skill directory at your Codex skills location and add a SKILL.md file with the required YAML frontmatter to enable discovery and onboarding.

Why does my Codex Skill need YAML frontmatter for discovery?▼

Codex Skills need YAML frontmatter for discovery because it enforces a consistent two-field structure (name and description) in SKILL.md. This standardization enables reliable skill discovery and scalable skill development across workflows.

Can I use templates to automate Codex Skill creation for specific workflows?▼

Yes, you can use templates to automate Codex Skill creation for specific workflows. The Skill Builder provides templates and best practices that enforce the four-level skill structure and standardize YAML frontmatter, enabling reliable and scalable skill development.