Use when the user wants to review their Claude Code usage insights, see session statistics, understand interaction patterns, or get a summary of how they use Claude Code
Generate, open, and extract actionable recommendations from Claude Code usage insights.
digraph insights_flow {
"Start" [shape=doublecircle];
"Run /insights" [shape=box];
"Report exists?" [shape=diamond];
"Open in browser" [shape=box];
"Read & extract" [shape=box];
"Done" [shape=doublecircle];
"Start" -> "Run /insights";
"Run /insights" -> "Report exists?";
"Report exists?" -> "Open in browser" [label="yes"];
"Report exists?" -> "Tell user to run /insights manually" [label="no"];
"Open in browser" -> "Read & extract";
"Read & extract" -> "Done";
}
Run the /insights command using the Skill tool:
Skill tool: skill: "insights"
If the Skill tool fails (built-in command), use Bash:
claude -p "/insights" --allowedTools "Read,Bash,Glob,Grep"
If both fail, ask the user to run /insights manually, then proceed to Step 2.
The report lives at ~/.claude/usage-data/report.html.
Open it in the default browser:
start "" "C:/Users/simon/.claude/usage-data/report.html"
Tell the user the direct URL: file:///C:/Users/simon/.claude/usage-data/report.html
Read the report HTML from ~/.claude/usage-data/report.html.
Do NOT output statistics (message counts, session counts, tool usage numbers, charts, etc.).
Instead, output the following sections in this exact order:
Extract from the section-friction area. Output as bullet points:
Extract from the section-features area. Output ALL content:
CLAUDE.md Additions: For each suggested CLAUDE.md item, output:
data-text attribute or cmd-code element) as a fenced code blockFeature Cards: For each feature card (Custom Skills, Hooks, Headless Mode, etc.), output:
Extract from the section-patterns area. Output ALL content:
For each pattern card, output:
Collect all headless mode (claude -p ...) command lines from anywhere in the report. Output each as a fenced code block with a brief label of what it does.
Extract from the section-horizon area. Output ALL content:
For each horizon card, output: