What is a Claude Code Skill?

A Claude Code Skill is a specialized capability that enhances Claude's behavior for specific tasks, providing domain-specific guidance, best practices, and implementation patterns that Claude can autonomously discover.

Why is progressive disclosure important for skills?

It allows Claude to scale to over 100 skills without context penalties by only loading detailed content (Level 2 and 3) when a skill is actually triggered via its Level 1 metadata.

Where should I store my custom skills?

Personal skills belong in ~/.claude/skills/ for global access, while project-specific skills should be placed in .claude/skills/ at the project root for version control.

Does this skill support nested subdirectories?

No, according to the specification, skills must be located directly under the top-level skills directory. Nested subdirectories or namespaces are not currently supported by Claude Code.

What are the mandatory fields for a new skill?

Every SKILL.md must start with a YAML frontmatter block containing exactly two fields: 'name' (maximum 64 characters) and 'description' (maximum 1024 characters).

Claude Skill Builder

Name: Claude Skill Builder
Author: ricable

byricable

•

開発者ツール

Automates the creation of production-ready Claude Code Skills using the progressive disclosure architecture and standardized YAML frontmatter.

Skill Builder is a specialized utility designed to streamline the development of custom Claude Code Skills. By enforcing the official Claude Skills specification—including required YAML frontmatter, optimized directory structures, and a three-level progressive disclosure system—this tool ensures that new capabilities remain context-efficient even when managing dozens of custom workflows. It is essential for developers looking to extend Claude's autonomous functionality across Claude.ai and Claude Code while maintaining high performance and strict organizational standards for local or team-shared environments.

主な機能

01Automated YAML frontmatter generation for autonomous skill discovery

02Context-optimized instruction formatting to minimize token consumption

03Standardized directory scaffolding for personal and project-specific skills

042 GitHub stars

05Enforcement of the 3-level progressive disclosure architecture for context efficiency

06Template generation for scripts, resources, and advanced documentation

ユースケース

01Scaffolding new domain-specific workflows for team-wide use in Claude Code

02Optimizing large instruction sets to fit the Claude Skills specification

03Converting existing documentation or scripts into discoverable AI agent skills

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