How does progressive disclosure improve skill performance?

It uses a three-level loading system (Metadata, SKILL.md body, and Bundled Resources) to ensure Claude only loads the information it needs, preserving the context window for actual work.

What should be included in the SKILL.md file?

SKILL.md must include YAML frontmatter with a specific name and description, followed by imperative procedural instructions and references to any bundled scripts or assets.

What is a Claude Code Skill?

A skill is a modular, self-contained package that extends Claude's capabilities by providing specialized knowledge, workflows, and tools for specific tasks or domains.

When should I use reference files instead of SKILL.md?

Detailed information like API schemas, company policies, or long patterns should be moved to the references/ directory to keep the core SKILL.md lean and discoverable.

How do scripts differ from assets in a skill?

Scripts are executable code (Python/Bash) used to perform deterministic tasks, while assets are non-context files like templates, logos, or boilerplate code used in Claude's final output.

Skill Development Framework

Name: Skill Development Framework
Author: arlenagreer

byarlenagreer

学習とドキュメンテーション

Provides a standardized framework and best practices for creating, structuring, and optimizing specialized skills within Claude Code plugins.

概要

This skill equips developers with a rigorous methodology for building modular, high-performance skills for Claude Code. It introduces a structured approach to skill architecture, emphasizing the principle of progressive disclosure to maintain context efficiency. By following this framework, developers can transform Claude into a specialized agent with domain-specific expertise, using standardized SKILL.md templates, optimized trigger phrases, and a clear separation between core instructions and bundled resources like scripts and references.

主な機能

Standardized SKILL.md metadata and frontmatter optimization
Step-by-step skill creation workflow from planning to validation
Management of bundled resources including scripts, references, and assets
Imperative writing style guidelines for high-quality AI instruction
Three-level progressive disclosure architecture for context window efficiency
0 GitHub stars

ユースケース

Refactoring bloated skill files into efficient reference-based structures
Optimizing skill discovery and trigger accuracy through better metadata
Bootstrapping a new domain-specific capability for a Claude Code plugin

概要

主な機能

Standardized SKILL.md metadata and frontmatter optimization
Step-by-step skill creation workflow from planning to validation
Management of bundled resources including scripts, references, and assets
Imperative writing style guidelines for high-quality AI instruction
Three-level progressive disclosure architecture for context window efficiency
0 GitHub stars

ユースケース

Refactoring bloated skill files into efficient reference-based structures
Optimizing skill discovery and trigger accuracy through better metadata
Bootstrapping a new domain-specific capability for a Claude Code plugin