Session-Stats
SkillCommunicationRender 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.
Available today. Use it from your connected AI after setup.
No other account needed.
Connect ahel once, and every AI you use reads what you have installed.
Then ask your AI: use the Session-Stats skill
What this skill tells your AI
The instructions your AI receives, as published by foyzulkarim/skills in dev-pipeline/skills/session-stats/SKILL.md and read by ahel’s review.
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
Signals
- GitHub stars
- 42
- Forks
- 14
- Last commit
- Sep 2026
Advanced
- Catalog kind
- skill
- Gateway key
session-stats- Source
- github.com/foyzulkarim/skills