Example Skill

---
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