How does Claude know when to use a specific skill?

Claude uses the 'name' and 'description' fields in the SKILL.md YAML frontmatter to determine when a skill is relevant to the user's current request.

What is a Claude Code Skill?

A skill is a modular package that extends Claude's capabilities with specialized knowledge, workflows, and tools for specific domains or tasks, acting as an onboarding guide for the AI.

How should I write the instructions in a SKILL.md file?

Instructions should be written in the imperative or infinitive form (verb-first) and in the third person to provide clear, objective guidance for the AI instance.

What is the benefit of the Progressive Disclosure design principle?

It manages context window efficiency by only loading what is necessary: metadata first, the SKILL.md body when triggered, and specific resources only as the task requires them.

When should I use a script instead of instructions in a skill?

Use scripts for tasks that require deterministic reliability or involve code that would be repeatedly rewritten by the AI, saving tokens and increasing accuracy.

Claude Skill Development

Name: Claude Skill Development
Author: nordeim

bynordeim

開発者ツール

Guides the creation and optimization of modular, domain-specific capabilities for Claude Code plugins using best practices and structured workflows.

概要

The Skill Development capability provides a comprehensive framework for building specialized extensions for Claude Code. It enables developers to transform Claude into a domain-expert agent by implementing the Progressive Disclosure design principle, which optimizes context window usage. The skill offers structured guidance on creating SKILL.md files, managing bundled resources like scripts and assets, and using imperative instruction styles to ensure Claude executes complex, multi-step procedures with deterministic reliability and specialized expertise.

主な機能

Progressive disclosure context management patterns
Optimization of YAML frontmatter for trigger phrases
Imperative instruction style enforcement for AI consumption
Resource bundling for scripts, references, and assets
0 GitHub stars
Standardized skill directory structure generation

ユースケース

Building a new domain-specific skill for a custom Claude Code plugin
Implementing deterministic scripts for repetitive code generation tasks
Optimizing large SKILL.md files by migrating content to modular references

概要

主な機能

Progressive disclosure context management patterns
Optimization of YAML frontmatter for trigger phrases
Imperative instruction style enforcement for AI consumption
Resource bundling for scripts, references, and assets
0 GitHub stars
Standardized skill directory structure generation

ユースケース

Building a new domain-specific skill for a custom Claude Code plugin
Implementing deterministic scripts for repetitive code generation tasks
Optimizing large SKILL.md files by migrating content to modular references