Agent skill

Session Analyzer

by bobmatnyc in bobmatnyc/claude-mpm

Debug and teach agentic coding: a deterministic-first session timeline + cost report, with optional narrative polish and a standalone JSX visualiser.

Custom licenceAuto-check passedAgent Workflows

Install Session Analyzer

skills CLI
$ npx skills add bobmatnyc/claude-mpm --skill session-analyzer -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install bobmatnyc/claude-mpm session-analyzer --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/bobmatnyc/claude-mpm.git skills-src && mkdir -p .claude/skills && cp -r skills-src/src/claude_mpm/skills/bundled/reporting/session-analyzer .claude/skills/session-analyzer && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
session-analyzer
GitHub stars
155
Token cost
~2.2k tokens
SKILL.md length
932 words
Files
3 (incl. scripts, references)
Skills in repo
52
Repo updated
First seen
Licence
Custom licence

At a glance

Debug and teach agentic coding: a deterministic-first session timeline + cost report, with optional narrative polish and a standalone JSX visualiser.

  • Works in 3 steps: Extract (deterministic, no inference) → Optional narrative polish (opt-in… → Render (deterministic)
  • Tasks that involve React components
  • SKILL.md covers When to use this skill, The hybrid workflow, What each captured data point… and Caveats, plus 2 more sections
  • Runs Python scripts from its folder; calls python and uv

What it does

Session Analyzer is an agent skill from bobmatnyc/claude-mpm. Debug and teach agentic coding: a deterministic-first session timeline + cost report, with optional narrative polish and a standalone JSX visualiser.

Its SKILL.md is about 2.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including scripts and reference files (for example `references/schema.md` and `scripts/session_timeline_to_jsx.py`).

It sits in Agent Workflows, covering React components. It works with Model Context Protocol. The repository describes itself as: Claude Multi-Agent Project Manager — multi-channel orchestration, GitHub-first SDK mode, and plugin system for Claude.

When your agent uses it

  • Tasks that involve React components

Example prompts

  • “/session-analyzer”

Requirements

  • Python 3

Workflow steps

3 steps, taken from the step headings in SKILL.md.

  1. Extract (deterministic, no inference)
  2. Optional narrative polish (opt-in inference)
  3. Render (deterministic)

What it can do on your machine

Read from SKILL.md and the folder at commit 25203d3. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python
    • uv

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use uv, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Session Analyzer loads about 2.2k tokens when it runs, and up to ~3.6k if it reads all its reference files. Until then it costs about 42 tokens; SKILL.md has 932 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~42
When it runs · the whole SKILL.md, loaded when a task matches
~2.2k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~3.6k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 932 words (~2,193 tokens).

“Produce a deterministic-first session report for debugging and teaching agentic coding with Claude MPM. The report reconstructs an entire session's timeline — every PM turn, subagent call, skill use, MCP call, the model behind each call, tokens in/out (plus cache)…”

— opening of SKILL.md by bobmatnyc, Custom licence
name
session-analyzer
skill_id
session-analyzer
skill_version
0.3.0
version
0.3.0
category
reporting
when_to_use
when analyzing a completed Claude session to understand cost breakdown, agent behavior, tool usage timeline, or to generate a visual session report
updated_at
2026-06-12T00:00:00Z
tags
session, reporting, cost, teaching, debugging
effort
medium
progressive_disclosure.references
references/schema.md

Read the full SKILL.md on GitHub

Files

SKILL.md and 2 other files (scripts, references) in src/claude_mpm/skills/bundled/reporting/session-analyzer of bobmatnyc/claude-mpm.

  • SKILL.md
  • references/schema.md
  • scripts/session_timeline_to_jsx.py

Open the folder on GitHubat commit 25203d3

Compare with similar skills

Session Analyzer next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Session Analyzer compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Session Analyzer this skillbobmatnyc/claude-mpm155—~2.2kAutomated safety check: PassCustom licence
Loora Design Guidelassejlv/loora140—~2.4kAutomated safety check: PassAGPL-3.0
Typescript Styletjx666/vscode-mcp106—~961Automated safety check: PassCustom licence
Zodjasonjgardner/blockbench-mcp-plugin4913 repos~1.4kAutomated safety check: PassGPL-3.0
Videoohad6k/emulo2931 repos~8.3kAutomated safety check: PassMIT
Frontmcp Auth UIagentfront/frontmcp146—~3.7kAutomated safety check: PassApache-2.0

Similar skills

  • Loora Design Guide

    lassejlv/loora

    Build, edit, refine, troubleshoot, and review polished responsive product interfaces through the Loora MCP server and its structured Canvas schemas.

    140 GitHub stars~2.4k tokensUpdated 11 days ago
    Frontend & DesignAuto-check passed
  • Typescript Style

    tjx666/vscode-mcp

    TypeScript code style and repo conventions for VSCode MCP — inference vs explicit types, ESM import suffixes, zod schema contracts, async VSCode/Node APIs, JSON-safe IPC results, JSDoc for public…

    106 GitHub stars~961 tokensUpdated 2 mo ago
    DevelopmentAuto-check passed
  • Zod

    jasonjgardner/blockbench-mcp-plugin

    Zod schema validation best practices for type safety, parsing, and error handling.

    491 GitHub starsUsed in 3 repos~1.4k tokens
    DevelopmentAuto-check passed
  • Video

    ohad6k/emulo

    A skill your agent uses when a brief has to become a film. An agent skill from ohad6k/emulo.

    293 GitHub starsUsed in 1 repo~8.3k tokens
    Frontend & DesignAuto-check passed
  • Frontmcp Auth UI

    agentfront/frontmcp

    A skill your agent uses when customizing, branding, or replacing the built-in FrontMCP OAuth pages (the login, consent, federated-select, incremental-authorization, and error pages) with your own…

    146 GitHub stars~3.7k tokensUpdated yesterday
    Backend & APIsAuto-check passed
  • Project Form Patterns

    AkaraChen/aghub

    Form implementation guidance for the aghub desktop app. An agent skill from AkaraChen/aghub.

    272 GitHub stars~1.1k tokensUpdated 2 days ago
    DevelopmentAuto-check passed

More from bobmatnyc/claude-mpm

All 52 skills in this repo
  • Build MCP Server

    bobmatnyc/claude-mpm

    Create high-quality MCP servers that enable LLMs to effectively interact with external services.

    155 GitHub stars~2k tokensUpdated 1 mo ago
    Auto-check passed
  • Env Manager

    bobmatnyc/claude-mpm

    Environment variable validation, synchronization, and management across local development, CI/CD, and deployment platforms

    155 GitHub stars~2k tokensUpdated 1 mo ago
    Auto-check: notes
  • Software Patterns

    bobmatnyc/claude-mpm

    Decision framework for architectural patterns including DI, SOA, Repository, Domain Events, Circuit Breaker, and Anti-Corruption Layer.

    155 GitHub stars~1.8k tokensUpdated 1 mo ago
    Auto-check passed
  • Verification Before Completion

    bobmatnyc/claude-mpm

    Run verification commands and confirm output before claiming success

    155 GitHub starsUsed in 2 repos~1k tokens
    Auto-check passed
  • Dependency Audit

    bobmatnyc/claude-mpm

    Dependency audit and cleanup workflow for maintaining healthy project dependencies.

    155 GitHub stars~3.5k tokensUpdated 1 mo ago
    Auto-check passed
  • Migration Wizard

    bobmatnyc/claude-mpm

    General protocol for executing migration skill wizards - service installation and configuration guides

    155 GitHub stars~1.9k tokensUpdated 1 mo ago
    Auto-check passed

Questions about Session Analyzer

What does Session Analyzer do?

Debug and teach agentic coding: a deterministic-first session timeline + cost report, with optional narrative polish and a standalone JSX visualiser. Session Analyzer is an agent skill from bobmatnyc/claude-mpm. Debug and teach agentic coding: a deterministic-first session timeline + cost report, with optional narrative polish and a standalone JSX visualiser.

When should I use Session Analyzer?

Session Analyzer fits situations like: tasks that involve React components.

How do I install Session Analyzer in Claude Code?

Run `npx skills add bobmatnyc/claude-mpm --skill session-analyzer -a claude-code`. Or copy the skill folder (src/claude_mpm/skills/bundled/reporting/session-analyzer in bobmatnyc/claude-mpm) into .claude/skills/session-analyzer in your project. Claude Code loads it when a task matches its description.

How do I install Session Analyzer in Codex?

Run `npx skills add bobmatnyc/claude-mpm --skill session-analyzer -a codex`. Or copy the skill folder (src/claude_mpm/skills/bundled/reporting/session-analyzer in bobmatnyc/claude-mpm) into .agents/skills/session-analyzer in your project. Codex loads it when a task matches its description.

Can I use Session Analyzer in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add bobmatnyc/claude-mpm --skill session-analyzer -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/session-analyzer, .gemini/skills/session-analyzer, .github/skills/session-analyzer and .opencode/skills/session-analyzer in your project.

What does Session Analyzer need to run?

Going by SKILL.md and its folder, Session Analyzer needs Python for the scripts in its folder and the command-line tools its instructions call (python and uv). Our summary lists: Python 3.

Does Session Analyzer access the network?

SKILL.md contains no URLs. Its commands use uv, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Session Analyzer safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Session Analyzer use?

Session Analyzer has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Session Analyzer use?

About 2.2k tokens (SKILL.md is roughly 8.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1.4k tokens, read only when the agent opens those files.

What are the alternatives to Session Analyzer?

Skills that share tags, products or a category with Session Analyzer: Loora Design Guide (lassejlv/loora, 140 stars), Typescript Style (tjx666/vscode-mcp, 106 stars), Zod (jasonjgardner/blockbench-mcp-plugin, 491 stars) and Video (ohad6k/emulo, 293 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Session Analyzer?

bobmatnyc (a GitHub user) maintains it in bobmatnyc/claude-mpm, which has 155 GitHub stars. The repository holds 52 skills in this directory. The repository was last updated on August 31, 2026.

Source: bobmatnyc/claude-mpm on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.