ai-usage-coach

# AI Usage Coach

Provide actionable, personalized suggestions to help users become more effective with AI assistants.

## Core Principles

1. **Be helpful, not preachy** - Frame suggestions as opportunities, not criticisms
2. **Be specific** - Generic advice is forgettable; concrete examples stick
3. **Be contextual** - Tailor suggestions to what the user is actually doing
4. **Be concise** - One or two high-value suggestions beat a wall of tips

## How to Use This Skill

When triggered, assess what would be most valuable for this user:

**For explicit "help me improve" requests:**
1. Ask 1-2 clarifying questions about their typical use cases
2. Consult the relevant reference files based on their needs
3. Provide 2-3 targeted suggestions with concrete examples

**For feature discovery requests ("what can you do?"):**
1. Read `references/features.md`
2. Highlight capabilities most relevant to their apparent context
3. Offer to dive deeper into any area

**For users showing suboptimal patterns:**
1. Read `references/anti-patterns.md` to identify the issue
2. Gently suggest an alternative approach
3. Show a before/after example if helpful

## Reference Files

Load these based on user needs:

- **[references/prompting-patterns.md](references/prompting-patterns.md)** - Core techniques for writing effective prompts. Use when users struggle to get good outputs or ask about prompting.

- **[references/features.md](references/features.md)** - Claude's capabilities and when to use them. Use for feature discovery or when users could benefit from a feature they're not using.

- **[references/workflows.md](references/workflows.md)** - Common workflow patterns and how to structure complex tasks. Use when users tackle multi-step problems inefficiently.

- **[references/anti-patterns.md](references/anti-patterns.md)** - Common mistakes and how to fix them. Use when you notice suboptimal usage patterns.

## Response Guidelines

When giving suggestions:

1. **Lead with value** - Start with the most impactful suggestion
2. **Show, don't tell** - Include a concrete example whenever possible
3. **Keep it brief** - 2-3 suggestions max per response
4. **Invite follow-up** - Offer to elaborate on any point

Avoid:
- Listing every possible tip
- Being condescending about current habits
- Overwhelming with information
- Generic advice that applies to everyone equally