Skill Builder

Create Codex Skills with YAML frontmatter and progressive disclosure structure.

Updated May 11, 2026
One-click install
npx skills add https://github.com/Turgunoff/mebellar_app --skill skill-builder-turgunoff
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: Skill Builder
Source: https://github.com/Turgunoff/mebellar_app/tree/main/.agents/skills/skill-builder
Command: npx skills add https://github.com/Turgunoff/mebellar_app --skill skill-builder-turgunoff

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Building custom Codex Skills requires knowing the exact SKILL.md format, YAML frontmatter rules, and directory conventions, and mistakes in any of these prevent the skill from being discovered or loaded correctly. ## Core Features & Use Cases - Specification Guidance: Explains the required name and description frontmatter fields, character limits, and formatting rules for valid SKILL.md files. - Progressive Disclosure Architecture: Teaches the 3-level loading model (metadata, SKILL.md body, referenced files) so skills scale without context bloat. - Ready-Made Templates: Provides basic, intermediate, and advanced skill templates plus validation checklists and real-world examples. - Use Case: A developer wants to package a repeatable workflow, such as generating React components, as a reusable skill for their team, and uses this skill to scaffold the directory, write compliant frontmatter, and organize scripts and resources. ## Quick Start Ask the assistant to create a new Codex Skill for your workflow and it will generate the SKILL.md with proper frontmatter and directory structure.

Frequently Asked Questions about Skill Builder

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

FAQPage Schema
How do I create a custom Codex Skill?▼

Create a directory directly under ~/.Codex/skills/ or .Codex/skills/ in your project, then add a SKILL.md file with YAML frontmatter containing name and description fields. The Markdown body below the frontmatter holds the instructions loaded when the skill activates.

What fields are required in SKILL.md frontmatter?▼

Only two fields are required: name (maximum 64 characters) and description (maximum 1024 characters). The description should state both what the skill does and when it should be invoked. Additional fields are ignored by Codex.

Can Codex Skills be nested in subdirectories?▼

No, skills must be placed directly under ~/.Codex/skills/[skill-name]/ or .Codex/skills/[skill-name]/ in a project root. Codex does not support nested subdirectories or namespaced skill folders.

What is progressive disclosure in Codex Skills?▼

Progressive disclosure is a 3-level loading system: name and description load at startup, the SKILL.md body loads when the skill is triggered, and referenced files load only on demand. This lets you install 100+ skills with minimal context usage.

Why is my skill not appearing in Codex?▼

Common causes include missing or malformed YAML frontmatter, a directory nested too deep instead of at the top level of the skills folder, or a name exceeding 64 characters. Restart Codex or refresh Codex.ai after fixing the structure.