Do skills perform differently on different Claude models?

Yes. While Opus has powerful reasoning and needs less hand-holding, Haiku often requires more explicit guidance. This skill helps you balance instructions for all target models.

Why is the description field critical for Claude Skills?

The description field is the primary mechanism for skill discovery. Claude uses it to evaluate and select the correct skill from over 100+ available options at runtime.

How does progressive disclosure improve skill performance?

It allows Claude to load only the core metadata initially, fetching deeper documentation and reference files only when they become relevant, which saves tokens and prevents context clutter.

What is the recommended naming convention for skills?

Anthropic recommends using the gerund form (verb + -ing), such as 'Processing PDFs' or 'Analyzing Data', because it clearly describes the activity the skill provides.

Anthropic Skill Best Practices

Name: Anthropic Skill Best Practices
Author: NeoLabHQ

byNeoLabHQ

•

542

•

개발자 도구

Applies Anthropic's official authoring guidelines to help developers build concise, well-structured, and discoverable Claude Code skills.

This skill acts as a specialized consultant for context engineering, ensuring that your custom Claude Code skills adhere to Anthropic's official best practices. It provides actionable guidance on metadata formatting, naming conventions, and progressive disclosure patterns to optimize agent performance. By implementing these standards, developers can improve skill discovery, minimize token consumption, and ensure their skills function effectively across the entire Claude model family, from the economical Haiku to the powerful Opus.

주요 기능

01Provides model-specific testing strategies for Haiku, Sonnet, and Opus

02542 GitHub stars

03Optimizes multi-file skill structures for complex domain-specific tasks

04Enforces gerund-based naming conventions for clear capability descriptions

05Implements progressive disclosure patterns to manage context window efficiency

06Standardizes SKILL.md YAML frontmatter for optimal agent discovery

사용 사례

01Structuring large documentation sets into organized, agent-readable sub-files

02Bootstrapping new Claude Code skills with production-grade metadata and naming

03Auditing existing custom skills for better discovery and lower token costs

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add neolabhq/context-engineering-kit apply-anthropic-skill-best-practices

For use in Claude.ai and ChatGPT

Download Skill