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.

主な機能

Automated YAML frontmatter generation for autonomous skill discovery
Context-optimized instruction formatting to minimize token consumption
Standardized directory scaffolding for personal and project-specific skills
2 GitHub stars
Enforcement of the 3-level progressive disclosure architecture for context efficiency
Template generation for scripts, resources, and advanced documentation

ユースケース

Scaffolding new domain-specific workflows for team-wide use in Claude Code
Optimizing large instruction sets to fit the Claude Skills specification
Converting existing documentation or scripts into discoverable AI agent skills

概要

主な機能

Automated YAML frontmatter generation for autonomous skill discovery
Context-optimized instruction formatting to minimize token consumption
Standardized directory scaffolding for personal and project-specific skills
2 GitHub stars
Enforcement of the 3-level progressive disclosure architecture for context efficiency
Template generation for scripts, resources, and advanced documentation

ユースケース

Scaffolding new domain-specific workflows for team-wide use in Claude Code
Optimizing large instruction sets to fit the Claude Skills specification
Converting existing documentation or scripts into discoverable AI agent skills