How does Claude know when to activate a skill?

Claude uses the 'name' and 'description' fields in the SKILL.md YAML frontmatter to determine when a skill's capabilities are relevant to the user's current request.

What is a Claude Code Skill?

A Claude Code Skill is a specialized, modular package that extends Claude's capabilities with domain-specific knowledge, tool integrations, and procedural workflows, essentially serving as an 'onboarding guide' for specific tasks.

What is the Progressive Disclosure principle in skills?

It is a design technique where the main SKILL.md is kept under 200 lines to save context. Detailed information is moved to 'references' or 'scripts' and only loaded by Claude when specifically needed for the task at hand.

Can I use Bash scripts in my custom skills?

While possible, it is recommended to use Node.js or Python instead. Bash scripts often lack full support on Windows, making Node/Python better for cross-platform compatibility.

What belongs in the 'references' folder versus the 'assets' folder?

The 'references' folder contains documentation for Claude to read and use in its reasoning process, while the 'assets' folder contains files like images, fonts, or templates meant to be used in Claude's output.

Skill Creator

Name: Skill Creator
Author: rafaelcalleja

byrafaelcalleja

•

開発者ツール

Streamlines the creation of modular Claude Code skills using standardized patterns and progressive disclosure principles.

The Skill Creator provides a structured framework and set of best practices for building high-quality Claude Code skills. It guides developers through the entire lifecycle of skill development—from initial planning and resource identification to implementation and packaging. By emphasizing the 'Progressive Disclosure' design principle, it ensures that skills remain context-efficient by keeping SKILL.md files lean and offloading detailed logic into modular scripts, references, and assets. This meta-skill is essential for anyone looking to extend Claude's capabilities with specialized domain knowledge, custom tool integrations, or complex procedural workflows.

主な機能

01Best practices for cross-platform script development (Node.js/Python) and environment handling

02Guidance on the Progressive Disclosure principle for optimal context window management

031 GitHub stars

04Standardized templates for SKILL.md and modular resource directories

05Step-by-step workflow for planning, initializing, and editing custom skills

06Strict metadata and formatting standards to ensure skill discoverability and automatic activation

ユースケース

01Organizing complex API documentation into modular references for better AI comprehension

02Creating reusable script bundles for repetitive development tasks like PDF manipulation or database migrations

03Building a custom domain-specific skill for internal company workflows and schemas

主な機能

01Best practices for cross-platform script development (Node.js/Python) and environment handling

02Guidance on the Progressive Disclosure principle for optimal context window management

031 GitHub stars

04Standardized templates for SKILL.md and modular resource directories

05Step-by-step workflow for planning, initializing, and editing custom skills

06Strict metadata and formatting standards to ensure skill discoverability and automatic activation

ユースケース

01Organizing complex API documentation into modular references for better AI comprehension

02Creating reusable script bundles for repetitive development tasks like PDF manipulation or database migrations

03Building a custom domain-specific skill for internal company workflows and schemas