Is the YAML frontmatter mandatory?

Yes, every SKILL.md file must start with YAML frontmatter containing a name and description for Claude to recognize and load the skill.

What is a Claude Code Skill?

A specialized capability that enhances Claude's behavior when performing specific tasks, providing domain-specific guidance and implementation patterns.

Where are custom skills stored?

Personal skills are stored in ~/.claude/skills/ for use across all projects, while project skills are stored in .claude/skills/ within your repository root.

Why should I use the Skill Builder instead of manual creation?

It ensures your custom skills follow the exact specifications required by Claude for autonomous discovery, preventing formatting errors and optimizing context window usage.

What is the progressive disclosure architecture?

It is a 3-level system that only loads full documentation when a skill is active, allowing you to install over 100 skills with minimal context penalty.

Claude Skill Builder

Name: Claude Skill Builder
Author: ricable

byricable

•

Learning & Documentation

Automates the creation of production-grade Claude Code Skills following the official specification and progressive disclosure patterns.

The Claude Skill Builder is a specialized utility designed to streamline the development of custom capabilities for Claude Code and Claude.ai. It ensures that every skill you create adheres to the exact specifications required for autonomous discovery, including mandatory YAML frontmatter and a directory structure optimized for the three-level progressive disclosure architecture. By guiding users through the creation of effective 'What' and 'When' trigger conditions, this skill helps developers build highly efficient, context-aware tools that scale to hundreds of entries without performance penalties.

Key Features

01Standardized directory structure setup for personal and project-based skills

02Enforcement of the three-level progressive disclosure architecture for context efficiency

031 GitHub stars

04Automated YAML frontmatter generation with character-limit validation

05Guided authoring for effective skill descriptions and trigger conditions

06Support for organizing scripts and resource folders within skill packages

Use Cases

01Standardizing team-wide project automation and internal documentation skills

02Optimizing large personal skill libraries to minimize context window usage

03Scaffolding new domain-specific Claude Code skills for specialized coding workflows

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add ricable/ultimate-ai-agent skill-builder

For use in Claude.ai and ChatGPT

Download Skill