When should I use the 'references/' directory?

Use the references directory for large documentation, schemas, or API specs that Claude should search or consult as needed, rather than loading them into every prompt.

How do I improve how often my skill is triggered?

Triggering is determined by the name and description in the SKILL.md YAML frontmatter. Use specific third-person trigger phrases that describe exactly when the skill should be used.

How long should the main SKILL.md file be?

Ideally, the body should be between 1,500 and 2,000 words. Detailed patterns and long-form content should be moved to reference files to maintain performance.

What is the 'progressive disclosure' principle in skill design?

It is a three-level loading system (Metadata, SKILL.md, and Resources) designed to keep the context window lean by only loading detailed information when Claude specifically needs it.

What is a Claude Code Skill?

A skill is a modular, self-contained package that extends Claude's capabilities with specialized knowledge, workflows, and tools, transforming it into a domain-specific agent.

Skill Development Guide

Name: Skill Development Guide
Author: lusya123

bylusya123

開発者ツール

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

概要

The Skill Development guide is an essential resource for developers building extensions for Claude Code. It provides a comprehensive framework for creating modular, self-contained skills that enhance Claude's capabilities with domain-specific workflows, tool integrations, and expert knowledge. By implementing progressive disclosure design principles and organizing content into scripts, references, and assets, developers can build highly efficient AI agents that manage context window usage effectively while maintaining deterministic reliability for complex tasks.

主な機能

Optimized metadata templates for improved skill triggering
Context-efficient progressive disclosure design patterns
Best practices for imperative instructional writing styles
Guidance for managing bundled scripts, references, and assets
Standardized multi-step skill creation workflow
0 GitHub stars

ユースケース

Standardizing skill structures across a large development team
Bootstrapping a new domain-specific skill for a Claude Code plugin
Optimizing existing plugin performance by migrating documentation to reference files

概要

主な機能

Optimized metadata templates for improved skill triggering
Context-efficient progressive disclosure design patterns
Best practices for imperative instructional writing styles
Guidance for managing bundled scripts, references, and assets
Standardized multi-step skill creation workflow
0 GitHub stars

ユースケース

Standardizing skill structures across a large development team
Bootstrapping a new domain-specific skill for a Claude Code plugin
Optimizing existing plugin performance by migrating documentation to reference files