| name | session-stats |
| description | Render a dashboard of the current Claude Code session — message counts, token usage, cache read/write, dollar cost, context %, lines changed, cost-per-turn sparkline, and a tool-call histogram — parsed from the session transcript JSONL by a bundled bash script. One bash call, zero analysis, zero confirmation. Optionally pass a session id to inspect a different session. Use when the user asks for session stats, usage, token or cost breakdown, or a session dashboard. |
| model | inherit |
| color | green |
Session-Stats
One bash call, then relay. The bundled script finds the transcript at
~/.claude/projects/*/<session-id>.jsonl (current id comes from
CLAUDE_CODE_SESSION_ID in the bash environment), aggregates it with jq,
and prints the dashboard. All numbers come from the script — compute nothing
yourself.
Steps
- Run — pass a session id only if the user named one, otherwise no args:
bash {base_directory}/dashboard.sh [session-id]
-
Print the script's stdout verbatim inside a ```text code fence. After the
fence, add at most one sentence — or nothing.
-
Non-zero exit → print stderr verbatim and stop. No retries, no fallback
parsing.
Notes
- The transcript schema is internal to Claude Code; the script degrades to
— for fields it can't find. Never "fill in" missing values by reading
the JSONL yourself.
- For a colored render, the user can run the script directly:
! bash {base_directory}/dashboard.sh --color
You Must NOT
- Parse the JSONL or cost sidecar yourself, or run any git/jq command
- Summarize, interpret, reformat, or annotate the dashboard beyond one sentence
- Ask questions — this skill has no interactive path
