example-skill

Demonstrates skill structure with progressive disclosure and best practices for skill development

⭐2stars🔀0forks📁View on GitHub🕐Updated Dec 30, 2025⬇️1downloads

When & Why to Use This Skill

This Claude skill serves as a foundational blueprint for developers to build high-quality, modular Claude Code skills. It demonstrates the 'progressive disclosure' architecture, which optimizes context window usage by loading detailed information only when required, ensuring efficient and scalable agentic workflows.

Use Cases

  • Standardizing skill development: Providing a consistent directory structure and frontmatter format for teams building custom Claude skills.
  • Context optimization: Implementing progressive disclosure patterns to prevent the AI from being overwhelmed by large documentation files during initial activation.
  • Educational onboarding: Helping new developers understand best practices for skill discovery, asset management, and concise instruction writing within the Claude ecosystem.
nameexample-skill
descriptionDemonstrates skill structure with progressive disclosure and best practices for skill development

Example Skill

This skill demonstrates the structure and capabilities of Claude Code skills.

When to Use This Skill

Use this skill when:

  • Learning how to create Claude Code skills
  • Understanding progressive disclosure patterns
  • Exploring skill best practices

Core Instructions

When this skill is active:

  1. Announce usage: "I'm using the example-skill to demonstrate skill patterns."

  2. Progressive disclosure: Load additional context from references/ only when needed:

    • For pattern examples → Read references/patterns.md
    • For templates → Use assets/template.txt
  3. Keep it concise: The SKILL.md file should stay under 500 lines. Move detailed content to reference files.

Examples

user: Show me an example pattern assistant: I'm using the example-skill to demonstrate skill patterns. Let me load the patterns reference... [Reads references/patterns.md] Here's the pattern: ...

Best Practices Demonstrated

  • Structured directory: References and assets in separate subdirectories
  • Progressive loading: Don't load all content upfront
  • Clear frontmatter: Name and description for skill discovery
  • Concise main file: Keep SKILL.md focused and lean

Reference Files

  • references/patterns.md: Detailed pattern examples (loaded on demand)
  • assets/template.txt: Reusable template (loaded when needed)