Skill

prism-analyze

Analyzes Claude Code session health using PRISM CLI: token usage, CLAUDE.md audits, failure diagnosis, project listing. Installs via pip if needed.

Python

Bash

developer-tools

monitoring

npx claudepluginhub jakeefr/prism --plugin prism

Tool Access

This skill uses the workspace's default tool permissions.

Preview

Analyze Claude Code session health using PRISM.

SKILL.md

Similar Skills

prism-advise

Audits CLAUDE.md files using PRISM CLI to recommend ADD, TRIM, WARN, and RESTRUCTURE changes based on session data. Use to fix rule violations, length issues, and placements.

prism

insights

Analyzes Claude Code session patterns, categories, trends, benchmarks, and usage for behavioral insights and recommendations. Activates on 'patterns', 'insights', 'how am I doing' queries.

1 file5 tools

claude-view

dashboard

Generates usage analytics dashboard from Claude Code sessions with epistemic protocol coverage metrics, friction analysis, growth timelines, and improvement recommendations.

1 file

epistemic-cooperative

Stats

Stars19

Forks1

Last CommitApr 27, 2026

Actions

View Source View Plugin View on GitHub View README

Help us improve

Share bugs, ideas, or general feedback.

prism-analyze

Analyze Claude Code session health using PRISM.

When to use

When the user asks to analyze their Claude Code sessions, check token usage, audit their CLAUDE.md, understand why sessions are failing, list their projects, or see what PRISM can see.

Before running

First check if PRISM is installed:

prism --version

If the command is not found, install it first:

pip install prism-cc

Then verify it installed correctly:

prism --version

Once confirmed installed, proceed with the analysis.

Usage

Run the analysis (reads JSONL from ~/.claude/projects/ by default):

prism analyze

If prism is not installed:

pip install prism-cc
prism analyze

For a specific project:

prism analyze --project <path>

For JSON output (useful for scripting):

prism analyze --json

For CLAUDE.md recommendations:

prism advise

List all projects PRISM can see:

prism projects

This prints each project name, session count, and last-active timestamp. Use it when the user asks what projects PRISM has data for, or to confirm that sessions are being recorded.

Agentsview data source

If the user has agentsview installed, PRISM can read from its SQLite database instead of raw JSONL. This gives real API token counts and agentsview's own health scores alongside PRISM's.

prism analyze --source agentsview
prism analyze --source agentsview --agentsview-db /path/to/sessions.db
prism analyze --source agentsview --json

DB path resolution when --agentsview-db is not specified: AGENTSVIEW_DATA_DIR env → AGENT_VIEWER_DATA_DIR env → ~/.agentsview/sessions.db

Use --source agentsview when the user mentions agentsview, asks for real token counts, or wants richer session data. Use the default (no flag) when they just want a quick analysis from raw session files.

What PRISM shows

Health scores (A-F) across 5 dimensions per project
Token efficiency: CLAUDE.md re-read costs, compaction frequency
Tool health: retry loops, edit-revert cycles, consecutive failures
Context hygiene: compaction loss events, mid-task boundaries
CLAUDE.md adherence: whether your rules are actually being followed
Session continuity: resume success rate, truncated sessions

Output

PRISM prints a health report table and top issues per project. Run prism (no args) to open the interactive TUI dashboard. Run prism dashboard to open the HTML dashboard in your browser.