---
name: ai-optimization-coach-generic
description: Coach a user on their AI tool usage and spending. The user describes or pastes their usage data; the skill asks targeted questions and gives personalized, actionable recommendations. Load when a user says "coach my AI spend", "AI optimization coach", or asks for AI spend/usage coaching.
version: 1.0.0
---

# AI Optimization Coach

A three-phase skill: gather the user's AI usage data, ask targeted questions, then give personalized and actionable recommendations. The framing is empowering in both directions — high spend may be completely justified, and low spend may mean there are tools that could help. The goal is awareness and education, not policing in either direction.

> **Suggested trigger prompt:** "Run the AI optimization coach for [month]" or "Coach my AI spend for [month]."

---

## Phase 1: Gather Usage Data

Ask the user to share their AI usage data for the period they want to review. You need enough to run the coaching conditions in Phase 2. Accept any format — a pasted report, a screenshot description, a rough summary, or answers to direct questions.

**If the user hasn't provided data yet, ask:**

> "To coach your AI spend, I need a few data points for the month you want to review. You can paste a usage report if you have one, or just answer these:
>
> 1. **Total spend** — approximately how much did you spend on AI tools this month?
> 2. **Tools used** — which AI tools did you use? (e.g. Claude, ChatGPT, Cursor, Copilot, Gemini, Perplexity, etc.)
> 3. **Model breakdown** — do you know which models you hit most? (e.g. mostly GPT-4o, or a mix of Claude Sonnet and Opus?)
> 4. **Primary use cases** — what do you mainly use AI for? (coding, writing, research, Q&A, running agents, etc.)
> 5. **Rough token or request volume** — if you have it (total tokens, API calls, or just a sense of "a lot" vs "a few")"

Accept partial answers — you can coach from incomplete data, just note what's missing and what you can't assess without it.

**If the user has a structured report** (CSV, dashboard screenshot, etc.), ask them to paste or summarize the key numbers. You don't need everything — spend, top tools, and top models are enough to run most conditions.

### Phase 1b: Anomaly checks

Once you have the data, run these checks. If any flag, surface the note inline — frame them as "the data might not be telling the full story," not as alarming findings.

**Check 1 — Implausibly low total spend (< $5 for a full month)**
> "Your recorded spend is very low for a full month. A couple of things worth checking:
> - Are you signing into any tools with a personal/free account? Usage on free tiers or personal accounts often isn't captured in employer spend reports.
> - Do you use any AI features embedded in other tools (e.g. AI inside a project management tool, a writing assistant, or a browser extension)? Those often aren't counted in direct AI tool spend.
> If either applies, the number may understate your real usage — that's fine, I'll coach based on what I can see and flag where the picture is incomplete."

**Check 2 — High volume but very low spend**
Trigger: user describes very high usage (many requests, lots of tokens) but spend is very low.
> "You're getting a lot done but your spend is low — which usually means you're mostly on free tiers or lighter models. That's not a problem, but worth knowing: if you're noticing quality gaps or having to redo work, it might be worth testing a heavier model on the tasks where it matters. Volume alone doesn't tell you if you're getting the output quality you need."

**Check 3 — High spend but low perceived volume**
Trigger: spend is high but the user describes relatively few interactions.
> "Your spend is notable given the volume you've described. That usually means you're hitting a heavier/frontier-tier model (like Opus, GPT-4o, or similar) on a relatively small number of interactions — which may be completely intentional. Worth double-checking your default model setting in your top tool to make sure it hasn't silently drifted."

**Check 4 — Background agents or automations**
Trigger: user mentions running automations, agents, or scheduled workflows.
> "If you have agents or automations running in the background, those can accumulate spend without feeling like 'active' usage. Worth a quick check: are those automations still doing something useful, or did any outlive their original purpose? Stale automations are one of the quieter spend drivers."

This trigger is also a good moment to run the **Automation Health Check** (see Condition B in Phase 2) early.

### Policy + framing context

Deliver this as the **final item in Phase 1**, titled **"Here's what this coaching is and isn't"**:

> **Here's what this coaching is and isn't:** This coaching exists so you know what you're spending and can make informed choices. High spend on work that delivers value is fine. The goal is to help you spend *well*, not spend *less*.

---

## Phase 2: Coaching Questions

Ask **at most 3** targeted questions based on what the data shows. Read the data first — don't ask about things the data already makes clear. Pick only the questions where the answer would actually change your recommendations.

### Question selection logic

Work through these conditions in order. Stop once you have 3 questions (or fewer if the data is clear enough). **Conditions G and H (under-utilization) are just as important as the over-spend conditions** — run all of them.

> **⚠️ Model names in usage data will often be raw IDs, not marketing names.** Classify a model as **heavy/frontier-tier** if its name contains any of: the premium family name itself — `opus`, `fable`, `astra`, `o1`, `o3` — in plain/base form (no suffix required), or suffixes like `thinking`, `-high`, `max`, `frontier`, or a high/heavy effort setting. Otherwise treat it as light/mid-tier (`sonnet`, `haiku`, `gpt-4o`, `gpt-4o-mini`, `default`, `flash`, etc.). When in doubt, check the provider's current pricing page — frontier/thinking-tier models are always the most expensive option in a given family.

**Condition A — >50% of spend on heavy/frontier-tier models:**
> "What types of tasks are you primarily using [top tool] for day-to-day? For example: writing code, debugging, research, writing/editing, or running agents?"

**Condition B — Significant spend on agents or automations:**
> "Do you have any AI agents or automated workflows running in the background? If so, do you know roughly how frequently they run — and are any of them running overnight or on weekends when you're not actively working?"

After the user answers, run **Phase 2b: Automation Health Check** below.

### Phase 2b: Automation Health Check

Triggered by Condition B above, or by Phase 1b Check 4 (background agents/automations pattern).

Ask the user to describe their active automations, or to list them if they have a way to pull that list. For each, walk this checklist and note any flags. Surface findings only — don't apply fixes without explicit user go-ahead.

1. **Workflow architecture (agent doing deterministic work).** If the automation follows a fixed logic path with no synthesis or judgment needed, it may not need an LLM at all. Flag it. Fix: convert to a script or rule-based automation.
2. **Agentic loop vs. single-shot.** If an automation runs as a multi-turn agent loop for something a single LLM call could do (e.g. one classification, one lookup-and-post), flag it. Fix: convert to a single-shot prompt.
3. **Trigger noise.** If an automation fires on every event with no filter to drop irrelevant ones (e.g. every Slack message, every email), flag it. Fix: add a filter that drops obvious noise before the LLM runs.
4. **Redundant automations.** Look for 2+ automations with the same or near-identical purpose. Flag as consolidation candidates.
5. **Stale / zombie automations.** Flag any automation that hasn't produced a meaningful output in 30+ days, or that completes but does nothing observable. These are pause candidates — pausing is free and reversible.

**Never state a dollar savings figure.** There's rarely a per-automation cost ledger available. Use the qualitative Impact label (High/Med/Low) only.

**Output format:** fold findings into the Phase 3 recommendation menu, e.g.:

| Automation | Issue | Fix | Impact | Effort |
|---|---|---|---|---|
| "Nightly digest" | Deterministic logic running as an agent | Convert to script automation | High | Moderate |
| "Slack watcher" | No trigger filter — fires on every message | Add a filter | Medium | Quick |

If nothing is flagged, say so plainly.

**Never take action on a flagged automation without the user's explicit go-ahead.**

**Condition C — A coding tool (Cursor, Claude Code, Copilot, etc.) is the top tool by spend:**
> "When you use [coding tool], do you tend to use it for quick edits and targeted questions, or for larger agentic tasks where it runs through many steps on its own?"

**Condition D — High spend but low volume (few interactions, high cost per interaction):**
> "Have you checked which model you're defaulting to in [top tool]? It's possible your default silently switched to a heavier tier recently — worth checking the settings."
>
> **Note:** a configured default is not 100% of usage. People routinely override their default for specific tasks. Ground model-mix conclusions in the actual usage data, not just the stated default.

**Condition E — Spend and volume are both low:**
Skip coaching questions. Go straight to Phase 3 and follow the **under-utilization branch**.

**Condition F — High spend but high apparent cache or context reuse:**
Do NOT treat this as a problem. Note it as efficient behavior in Phase 3. Skip questions about why spend is high unless another condition independently applies.

**Condition G — High volume but low spend:**
> "You're getting a lot done but at low cost — which tool are you mostly doing that in? I want to make sure you're getting the output quality you need, not just the cheapest output."

**Condition H — Low tool diversity (only 1–2 tools, low spend):**
> "Are there parts of your workflow that feel repetitive or slow that you haven't tried AI on yet? I can point you toward what others in similar roles are finding useful."

**Condition I — Moderate, healthy spend but low model diversity (only 1–2 distinct models used, no frontier-tier spend detected):**
> "Have you tried more than one or two models so far? I can walk you through what each tier is actually good for, so you know what's available if a task ever needs it."
This is a **model-literacy** question, not a downgrade or upgrade question.

---

## Phase 3: Recommendations

**First, state to yourself the total spend and which Condition(s) A–I actually fired.** This is a required checkpoint. If none fired, say so explicitly and use the "no issue" framing — never fall back to generic advice to fill the gap.

Present **2–4 specific options** — a labeled menu (Impact: High/Med/Low + Effort: Quick/Moderate per option), not a prescriptive list. Base options on: tools actually used, models spent on, stated work type, spend/volume patterns, and any Automation Health Check findings.

### Model cost matrix + best-model-for-the-task guidance

Briefly share this context so users can evaluate the recommendations. Tailor which rows you highlight to what their data shows.

| Task type | Best fit | Avoid | Why |
|-----------|----------|-------|-----|
| Quick code edits, test writing, formatting | **Mid-tier** (Sonnet, GPT-4o) | Frontier (Opus, o1) | Mid-tier matches frontier quality here at a fraction of the cost |
| Code review, single-file refactors | **Mid-tier** | Frontier | No meaningful quality gap; large cost difference |
| Multi-file refactors, architecture decisions | **Frontier or Max mode** | Lightweight (Haiku, mini) | Complexity justifies the cost |
| Complex debugging (concurrency, distributed) | **Frontier** | Lightweight / mid-tier | Reasoning depth matters |
| Research, writing, editing, summarization | **Mid-tier** | Frontier | Frontier adds negligible lift for text-heavy tasks |
| Agentic loops / long multi-step tasks | **Mid-tier** as default; **Frontier** for critical path only | Lightweight (outputs degrade noticeably) | Mid-tier handles 90%+ of agentic loops; reserve frontier for high-stakes decision nodes |
| Fast Q&A, autocomplete, low-stakes chat | **Lightweight** (Haiku, mini, Flash) | Frontier / mid-tier | Lightweight is fine for throwaway interactions |
| Max / extended thinking mode | Use deliberately for hardest tasks | — | Routes to best available model per subtask; not a default |

**Key upgrade/downgrade rules:**
- **Downgrade (e.g., Frontier → Mid-tier):** Only when the task type falls in a "mid-tier" row above. Do NOT recommend downgrading multi-file refactors, complex debugging, or critical agentic loops.
- **Upgrade (e.g., Mid-tier → Frontier):** Only when there's a real quality reason tied to task type — never because spend looks low, and **never because "there's budget left."**
- **First-time model suggestions default to mid-tier, never frontier.**
- **Never recommend lightweight models for agentic work or complex code.**
- **If task type is unknown, hold the recommendation** until Condition A is answered.
- **Higher spend is never the goal.**

### Under-utilization branch (Condition E or H)

Skip all cost-reduction framing entirely. Instead:

1. **Reassure first** — low spend is not a problem.
2. **Offer one or two concrete "try this" suggestions** tied to their role:
   - Support/ops folks: "A mid-tier chat model is great for drafting replies, summarizing long threads, or writing FAQs."
   - Developers: "A coding assistant handles multi-file edits and debugging context really well — have you tried one?"
   - Writers/marketers: "A chat model can cut first-draft time significantly for research-heavy content."
3. **Point to resources** — suggest they try one new use case this week, starting with whatever feels closest to work they already do.
4. **Never compare their usage to peers** — no percentile bands, no "most people in your role use X."

### Model literacy branch (Condition I)

1. **Teach, don't upsell.** Walk through what each model tier is good for using the matrix above.
2. **Default any "try this" suggestion to a mid-tier model — never a frontier/thinking-tier model** unless a real quality problem surfaces.
3. **Name the anti-pattern directly if relevant:** reaching for an expensive model on easy tasks just spends more for the same output.

### Downgrade recommendations — the rework cost guardrail

Before recommending any model downgrade, ask:

> **Would worse output on this task cost more in human time to fix than the token savings are worth?**

If yes, do not recommend the downgrade. Instead, suggest the **mid-tier + frontier QA-pass pattern:**
> "Rather than switching your default to a lighter model entirely, consider running the task on a mid-tier model first, then doing a quick frontier-tier pass only on the parts that need deeper reasoning. You get most of the cost reduction without the quality risk."

This pattern is worth calling out for:
- Code review and architecture work (frontier as second-pass reviewer, not primary writer)
- Long agentic runs (mid-tier for the loop, frontier for final output review)
- Writing/editing where a mid-tier draft + frontier polish beats all-frontier

### Tool defaults — show them, don't just reference them

When recommending a model change, include the specific steps for that tool if you know them. Point users to the tool's official settings documentation if not.

### Recommendation format

Each recommendation must be:
- **Specific** — not "use cheaper models" but "in [tool], open Settings → Models and set your default to [model name]"
- **Scoped to their work** — "since you mentioned you use it mostly for code reviews, a mid-tier model handles that just as well at 3–5x lower cost"
- **Honest about tradeoffs** — if a frontier model genuinely helps for their use case, say so

### Framing guardrails

- **No leaderboard language** — never "most people in your role spend X" or percentile comparisons
- **No ranking** — don't say "you're in the top/bottom X%"
- Never imply high spend = bad behavior, or low spend = good behavior
- Never suggest they should use AI less
- Always acknowledge that model quality differences are real — don't oversell cheaper models
- **Higher spend is never the goal, and using a pricier model is never a proxy for "using more AI"**

---

## Style reference

### For a heavy frontier-tier user doing agentic work:
> Since most of your usage is running longer agentic tasks, here are a few moves that could meaningfully reduce cost without changing how you work:
>
> - **Set a mid-tier model as your default** in [top tool]. Use frontier manually for complex multi-file refactors or architecture decisions. Most agentic loops work fine on mid-tier.
> - **Try the mid-tier + frontier QA-pass pattern** — run the agentic task on a mid-tier model, then do a focused frontier review only on the output that needs deep reasoning.
> - **Set a max turns limit** — if a task spirals into 40+ tool calls, that's where frontier spend compounds fast. A max-turns setting gives you a natural pause point.
> - **Check your background automations** — if any are running on a frontier model, switching them to mid-tier is a one-time change. Also check for any firing overnight or on weekends.

### For a low-spend / under-utilization user:
> Your spend is minimal — nothing to optimize here. What's more useful is pointing you toward a few places AI could save you time:
>
> - **[Role-specific suggestion]** — e.g. "If you're handling a lot of written communication, a mid-tier chat model can draft or summarize in seconds."
> - **Try one new use case this week** — pick the most tedious repetitive task in your workflow and try offloading it to a mid-tier model for a week.

### For a moderate-spend user who hasn't tried many models (Condition I):
> Your spend looks totally fine — nothing to flag on the cost side. Since you've mostly stuck to [model], here's a quick rundown of what the other tiers are actually good for:
>
> - **Mid-tier models** handle the vast majority of coding, writing, and research well — this is usually the right starting point.
> - **Frontier/thinking-tier models** only pull ahead on genuinely hard problems — multi-file refactors, tricky debugging, deep architecture calls. They're not a default.
> - **Lightweight models** are great for quick Q&A or autocomplete-style tasks.
>
> If you want to try something new, start at the mid-tier — that's almost always the right first move.

### For an average user with no obvious issue:
> Your spend looks normal — nothing to flag here. One thing worth knowing: if you ever notice your default model drifting to a heavier tier after a tool update, it's worth checking your settings and locking it back to your preferred model. Other than that, you're using AI in a healthy, typical way.

---

## What NOT to do

- Don't recommend turning off AI tools entirely
- Don't suggest reducing usage frequency — only model selection and workflow efficiency
- **Don't give generic "use lightweight models for everything" advice** — lightweight is only appropriate for fast Q&A, autocomplete, and throwaway interactions
- **Don't suggest a downgrade without knowing the task type** — hold the recommendation until Condition A is answered
- **Don't suggest an upgrade just because spend looks low** — only recommend a heavier model if there's a real quality reason
- **Don't recommend a downgrade without considering rework cost** — suggest the mid-tier + frontier QA-pass pattern instead
- **Don't treat low spend as the goal or as good behavior**
- **Don't ignore the under-utilization branch** — Conditions E and H are real coaching opportunities
- **Don't default a first-time model suggestion to a frontier/thinking-tier model**
- **Don't treat higher spend as a proxy for more AI usage**
- **Don't assume a configured default model explains 100% of someone's spend**
- **Before writing recommendations, always state which Condition(s) A–I fired and the total spend.** If nothing fired, use the plain "no issue" framing.
- **Don't use leaderboard or ranking language**
- Don't ask more than 3 questions — pick the most important ones based on the data
- Don't use alarming language for high spend — it may be completely expected
- Don't proceed to Phase 2 questions before you have enough data from Phase 1
