What is a Claude Code Skill?

A Claude Code Skill is a specialized capability that enhances Claude's behavior by providing domain-specific guidance, workflows, and tools packaged in a modular format.

What is the Progressive Disclosure principle?

It is a three-level loading system designed to save tokens: Claude first reads metadata, then the SKILL.md body, and finally loads external resources only when specifically needed.

How do I structure a Claude Code skill directory?

A skill requires a SKILL.md file with YAML frontmatter. It can optionally include subdirectories for scripts (executable code), references (documentation), and assets (output templates).

How should I write the instructions in SKILL.md?

Instructions should be written in imperative/infinitive form (verb-first) and avoid second-person language to maintain consistent and clear AI consumption.

When should I use a reference file vs. putting content in SKILL.md?

Keep SKILL.md lean (1,500-2,000 words). Move detailed schemas, API references, and long documentation to the references/ directory to keep the core context window clear.

Skill Architect for Claude Code

Name: Skill Architect for Claude Code
Author: astrosteveo

byastrosteveo

•

개발자 도구

Guides developers through the end-to-end process of creating, structuring, and optimizing specialized skills for Claude Code plugins.

소개

The Skill Development skill provides a standardized framework for building modular, high-performance extensions for Claude Code. It transforms Claude into an expert consultant that helps developers navigate the complete skill lifecycle—from identifying concrete use cases and planning reusable resources to implementing progressive disclosure design principles. By following this skill's structured methodology, developers can create context-efficient packages that combine procedural knowledge, executable scripts, and deep reference material, ensuring Claude performs with domain-specific precision.

주요 기능

Imperative-style instruction templates for high-quality AI behavior
Progressive disclosure design for optimized context window management
Optimization strategies for YAML frontmatter and skill trigger phrases
Step-by-step skill creation and validation workflow
Standardized directory structure for scripts, references, and assets
1 GitHub stars

사용 사례

Improving AI reliability by moving repetitive code into deterministic scripts
Refactoring complex prompts into modular, resource-backed skill packages
Building specialized domain expertise into custom Claude Code plugins

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add astrosteveo/marketplace skill-development

For use in Claude.ai and ChatGPT

Download Skill

GitHub

소개