| name | skill-retro |
| description | Bulletproof skill-usage retrospective from local Copilot history. Prefer omp skill-retro (not history analyze). Simple or advanced tables, optional HTML. Use for skill usage retros, times used, tokens, spend. |
Skill Retro (bulletproof)
Use /skill-retro to request this local metadata-only skill-usage retrospective.
Local Copilot session-state only. Never read conversation content.
Hard rules (cheap-model safe)
- Only run the
omp skill-retro command below.
Never run omp history analyze.
Never invent flags if a command fails.
Never use JSON mode (--json).
Never reformat tables into bullets or one long line.
- If
omp skill-retro is not found or fails → stop. Tell the user to install/link the omp that includes skill-retro. Do not fall back to other commands.
- The CLI prints markdown tables plus a plain What next? section. Show that stdout to the user as the answer.
1. Ask view once (plain words)
Do you want a quick summary (recommended) or the full detailed report?
- Quick summary → simple
- Full detailed report → advanced
- Silence → simple
Do not ask with flag names.
2. Run exactly one command
Quick summary (default):
omp skill-retro
Full detailed report:
omp skill-retro advanced
After the user picks a next step (only then):
Hard rule: every follow-up must re-use the exact same window, project, and price from the last successful run. Never drop back to defaults (14d / all / no price) when the user already chose different filters.
| User says | What you do |
|---|
| more detail / full | same filters + advanced |
| simpler / summary / quick | same filters + simple |
| dollar estimates / pricing / $ | same filters + same view + --price public |
| save html / html / browser | same filters + current view + --html then ask open (below) |
| open / yes / open it (after HTML) | only then run open '<path>' (macOS) |
| no / skip / done | stop |
Examples (preserve filters):
omp skill-retro advanced --days 90 current --price public
omp skill-retro simple --days 90 current --price public --html
Default days stay 14 only when the user never chose another window.
Aliases: omp retro.
3. Present
- Paste CLI stdout as-is (tables + What next?).
- Do not rewrite numbers or dates.
- Do not invent technical flag lists as next steps.
4. HTML flow (important)
When the user asks to save as HTML / html:
- Run
omp skill-retro simple --html (or advanced if that was the current view).
- Show the CLI output (includes HTML report ready + path + open question).
- Stop and wait. The CLI already asks: “Open this report in your browser now?”
- Only if they reply yes / open / open it → run exactly:
open '<absolute-path-from-cli>' (macOS).
- Never run
open in the same turn as --html.
- Never open automatically.
Fail closed
| Situation | Action |
|---|
skill-retro unknown | Stop + link/update omp |
| Exit non-zero | Show error only |
| Want JSON | Refuse; use text stdout |
What each view shows
- Quick (simple): snapshot, top skills (UK dates), API usage always (AI credits + tokens + premium/duration when present), by-model API usage always (tokens + AI credits; public USD only after dollar estimates), single-skill associations.
- Full (advanced): all of that + full session metrics + spend/models + shared + warnings.
- Never show a USD-from-credits dollar column; AI credits (usage units) always appear in API usage + by-model.
