Skill Builder

Create Codex Skills with YAML frontmatter and progressive disclosure structure.

Updated Feb 17, 2026
One-click install
npx skills add https://github.com/derbalimajd04-dot/al-wasat --skill skill-builder-derbalimajd04-dot
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: Skill Builder
Source: https://github.com/derbalimajd04-dot/al-wasat/tree/main/.agents/skills/skill-builder
Command: npx skills add https://github.com/derbalimajd04-dot/al-wasat --skill skill-builder-derbalimajd04-dot

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Building custom AI skills requires understanding YAML frontmatter rules, directory layout constraints, and progressive disclosure architecture, and mistakes in any of these cause skills to fail discovery or waste context. ## Core Features & Use Cases - Specification Guidance: Defines the required name and description frontmatter fields with length limits, formatting rules, and valid examples. - Progressive Disclosure Architecture: Explains the 3-level loading model (metadata, SKILL.md body, referenced files) so skills scale without context penalty. - Templates and Checklists: Provides basic, intermediate, and advanced skill templates plus a validation checklist covering structure, content quality, and testing. - Use Case: A developer wants to package a repeatable workflow, such as generating React components, as a discoverable skill for their team, and uses this skill to produce a compliant SKILL.md with scripts and resources directories. ## Quick Start Ask the AI to create a new skill named my-first-skill with a proper SKILL.md including name, description, quick start, and step-by-step instructions.

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. Follow with markdown sections covering what the skill does, quick start, and step-by-step instructions.

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.

Can skills be nested in subdirectories?▼

No, skills must be placed directly under the skills directory as top-level folders. Nested subdirectories or namespaces are not supported and will prevent the skill from being discovered.

What is progressive disclosure in skill design?▼

Progressive disclosure loads skill content in three levels: name and description at startup, the SKILL.md body when the skill is triggered, and referenced files only on demand. This keeps context usage minimal even with many installed skills.

Why is my skill not appearing in the skill list?▼

Common causes include missing or malformed YAML frontmatter, the skill directory being nested instead of top-level, or a name exceeding 64 characters. Verify the frontmatter starts and ends with --- and contains valid name and description fields.