What is a Claude Code Skill?

A Claude Code Skill is a specialized capability consisting of instructions and resources that enhance Claude's behavior when performing specific domain-based tasks.

How do I structure a new skill directory?

A skill requires a SKILL.md file at its root and can include optional subdirectories for scripts (executable code), references (documentation), and assets (output templates).

What is the benefit of progressive disclosure?

Progressive disclosure allows Claude to load only necessary metadata initially, then the full skill body, and finally specific resources as needed, significantly saving context window tokens.

Why should I use imperative language in skills?

Using verb-first, objective instructions (e.g., 'Execute the validation script') provides clearer, more deterministic guidance for AI models compared to conversational language.

Where should I store large API schemas or documentation?

Large reference materials should be placed in the 'references/' directory rather than the SKILL.md file to keep the core skill instructions lean and performant.

Skill Development for Claude Code

Name: Skill Development for Claude Code
Author: stevessr

bystevessr

0•

開発者ツール

Streamlines the creation and optimization of specialized capabilities for Claude Code plugins using standardized structures and best practices.

This skill acts as a comprehensive framework for developers building Claude Code plugins, providing rigorous guidance on how to architect, write, and organize skill-based capabilities. It enforces essential design principles like progressive disclosure to manage context window efficiency and provides a structured workflow for creating SKILL.md files, scripts, and reference materials. By following this skill's methodology, developers can ensure their plugins are discoverable via optimized metadata and highly effective at performing complex, domain-specific tasks through clear, imperative instructions.

主な機能

01Standardized SKILL.md template generation with optimized YAML metadata

02Structured organization for scripts, reference documentation, and assets

03Comprehensive validation checklist for skill directory structures and trigger phrases

04Imperative writing style enforcement for improved AI instruction following

05Three-level progressive disclosure system for efficient token management

060 GitHub stars

ユースケース

01Migrating complex domain knowledge into structured reference files for better discoverability

02Optimizing existing skill documentation to reduce context bloat while maintaining performance

03Architecting a new specialized skill for a custom Claude Code plugin from scratch

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add stevessr/dotsfiles skill-development

For use in Claude.ai and ChatGPT

主な機能

01Standardized SKILL.md template generation with optimized YAML metadata

02Structured organization for scripts, reference documentation, and assets

03Comprehensive validation checklist for skill directory structures and trigger phrases

04Imperative writing style enforcement for improved AI instruction following

05Three-level progressive disclosure system for efficient token management

060 GitHub stars

ユースケース

01Migrating complex domain knowledge into structured reference files for better discoverability

02Optimizing existing skill documentation to reduce context bloat while maintaining performance

03Architecting a new specialized skill for a custom Claude Code plugin from scratch