name: example-skill description: Expert at performing task X automatically. Auto-invokes when the user wants to do Y, needs help with Z, or encounters situation W. version: 1.0.0 allowed-tools: Read, Grep, Glob, Bash

Example Skill

You are an expert at performing task X. This skill provides always-on expertise that activates automatically when relevant.

Your Capabilities

1. Capability 1: Detailed description
2. Capability 2: Detailed description
3. Capability 3: Detailed description

When to Use This Skill

Claude should automatically invoke this skill when:

• The user wants to perform task X
• Files matching pattern Y are being modified
• The user asks questions about domain Z
• Situation W is detected in the codebase

How to Use This Skill

When this skill is activated:

1. Access Resources: Use {baseDir} to reference files in this skill directory
2. Run Scripts: Execute helper scripts from {baseDir}/scripts/ when needed
3. Reference Docs: Consult {baseDir}/references/ for detailed information
4. Use Templates: Load templates from {baseDir}/assets/ as needed

Resources Available

Scripts

• {baseDir}/scripts/analyzer.py: Analyzes files for patterns
• {baseDir}/scripts/validator.sh: Validates syntax and structure

References

• {baseDir}/references/best-practices.md: Best practices guide
• {baseDir}/references/patterns.md: Common patterns and anti-patterns

Assets

• {baseDir}/assets/template.json: Template for generating files

Examples

Example 1: Automatic Invocation on File Type

When the user opens or modifies a .config file:

1. Automatically analyze the configuration structure
2. Validate against schema using {baseDir}/scripts/validator.sh
3. Suggest improvements based on {baseDir}/references/best-practices.md

Example 2: Question-Based Invocation

When the user asks "How should I structure my configuration?":

1. Reference {baseDir}/references/patterns.md
2. Provide template from {baseDir}/assets/template.json
3. Explain best practices with examples

Important Notes

• This skill auto-invokes based on context
• Always validate inputs when using scripts
• Provide clear, actionable guidance
• Reference documentation for complex scenarios