Skill Builder

Generate Codex Skill templates with SKILL.md frontmatter and progressive disclosure structure.

1|Updated Feb 7, 2026
One-click install
npx skills add https://github.com/MarcoDava/MockCortex --skill skill-builder-marcodava
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Skill Builder
Source: https://github.com/MarcoDava/MockCortex/tree/main/.agents/skills/skill-builder
Command: npx skills add https://github.com/MarcoDava/MockCortex --skill skill-builder-marcodava

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Skill creation and templating is error-prone and inconsistent across projects. Skill Builder standardizes the process by providing a template-driven approach to generate production-ready Codex Skills with proper YAML frontmatter and a scalable progressive disclosure structure.

Core Features & Use Cases

  • Enforces YAML frontmatter with required fields (name and description) and a concise description that includes trigger conditions.
  • Provides a progressive disclosure structure (Level 1 metadata, Level 2 SKILL.md body, Level 3+ references) to scale to 100+ skills.
  • Supplies ready-to-use skeletons for top-level skill directories, optional scripts/references/assets, and navigation guidelines for future documentation.
  • Use cases: creating new Codex Skills for workflows, generating skill templates, converting ideas into formalized, reusable skills.

Quick Start

Create a new skill directory at ~/.Codex/skills/your-skill and populate SKILL.md with valid YAML frontmatter and a progressive disclosure structure, then validate the skill with Codex tooling.

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 Codex Skill with proper YAML frontmatter?

To create a Codex Skill, generate a SKILL.md file with valid YAML frontmatter containing required name and description fields, then structure the body content using progressive disclosure levels for scalable navigation.

What is progressive disclosure structure in skill documentation?

Progressive disclosure structure organizes skill documentation into hierarchical levels: Level 1 metadata, Level 2 SKILL.md body, and Level 3+ references, enabling scalable navigation across 100+ skills without overwhelming users.

Does Codex skill creation require specific directory placement?

Codex skill creation requires placing your skill directory at ~/.Codex/skills/your-skill and populating it with a SKILL.md file containing valid YAML frontmatter and progressive disclosure structure.

Can I convert existing repositories into Codex Skills?

Yes, you can convert existing repositories into Codex Skills by adding properly formatted SKILL.md frontmatter with required name and description fields, then restructuring documentation into progressive disclosure levels.

What are the limitations when generating skill templates for workflows?

Skill template generation enforces frontmatter requirements with mandatory name and description fields, enforces size recommendations, and requires clear navigation between disclosure levels to ensure ready-to-publish templates.

Why does my SKILL.md frontmatter validation fail?

SKILL.md frontmatter validation fails when required YAML fields like name and description are missing, or when the description lacks trigger conditions needed for proper skill discovery and activation.