Why is the imperative form recommended for skill instructions?

Using verb-first, objective language (e.g., 'Perform X' instead of 'You should do X') provides clearer, more authoritative guidance that improves model following and consistency.

What is the anatomy of a Claude Code Skill?

A skill consists of a required SKILL.md file with YAML metadata and instructions, and optional directories for scripts (executable code), references (documentation), and assets (templates or static files).

When should I use a script instead of writing instructions in SKILL.md?

Scripts should be used for tasks that require deterministic reliability, complex logic that the AI might otherwise rewrite incorrectly, or repetitive operations that are token-intensive.

How does progressive disclosure benefit skill development?

It manages the AI's context window by only loading essential metadata initially, then loading the skill body or external resources only when Claude determines they are needed for the current task.

Claude Skill Development

Name: Claude Skill Development
Author: troykelly

bytroykelly

•

开发者工具

Provides a standardized framework for creating, organizing, and optimizing modular skills to enhance Claude Code's domain-specific capabilities.

关于

This skill serves as a comprehensive guide for developers looking to extend Claude Code's functionality through custom skills. It implements an opinionated, GitHub-native workflow that covers the entire development lifecycle—from conceptualization and planning reusable resources to implementing progressive disclosure design principles. By following this skill's guidance, developers can build context-efficient, modular packages that include specialized workflows, tool integrations, and domain expertise, transforming Claude into a specialized agent for any technical environment.

主要功能

5 GitHub stars
Guidelines for imperative, verb-first instruction writing for AI consumption
Best practices for defining high-quality skill discovery trigger phrases
Progressive disclosure design patterns for efficient context window management
Management workflows for scripts, references, and static assets
Standardized skill directory structure and YAML metadata templates

使用场景

Optimizing plugin performance by moving large documentation into reference files
Standardizing AI behavior across a development team with shared skill repositories
Building custom domain-specific automation skills for private internal workflows

关于

主要功能

5 GitHub stars
Guidelines for imperative, verb-first instruction writing for AI consumption
Best practices for defining high-quality skill discovery trigger phrases
Progressive disclosure design patterns for efficient context window management
Management workflows for scripts, references, and static assets
Standardized skill directory structure and YAML metadata templates

使用场景

Optimizing plugin performance by moving large documentation into reference files
Standardizing AI behavior across a development team with shared skill repositories
Building custom domain-specific automation skills for private internal workflows