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.

주요 기능

Best practices for cross-platform script development (Node.js/Python) and environment handling
Guidance on the Progressive Disclosure principle for optimal context window management
1 GitHub stars
Standardized templates for SKILL.md and modular resource directories
Step-by-step workflow for planning, initializing, and editing custom skills
Strict metadata and formatting standards to ensure skill discoverability and automatic activation

사용 사례

Organizing complex API documentation into modular references for better AI comprehension
Creating reusable script bundles for repetitive development tasks like PDF manipulation or database migrations
Building a custom domain-specific skill for internal company workflows and schemas

소개

주요 기능

Best practices for cross-platform script development (Node.js/Python) and environment handling
Guidance on the Progressive Disclosure principle for optimal context window management
1 GitHub stars
Standardized templates for SKILL.md and modular resource directories
Step-by-step workflow for planning, initializing, and editing custom skills
Strict metadata and formatting standards to ensure skill discoverability and automatic activation

사용 사례

Organizing complex API documentation into modular references for better AI comprehension
Creating reusable script bundles for repetitive development tasks like PDF manipulation or database migrations
Building a custom domain-specific skill for internal company workflows and schemas