Agent skill · data analytics · aradotso
claude-doctor-session-diagnostics
claude-doctor-session-diagnostics — an agent skill for coding agents.
Why this skill is useful
Adds specific behavioral diagnostics and rule generation capabilities for Claude sessions that the AI wouldn't reliably generate on its own.
What it needs
Requires claude-doctor installed locally. About 4k tokens when loaded. Last updated 2026-07-09. 70 stars on the source repository.
What this skill does
bash Global install npm i -g claude-doctor Or run without installing npx claude-doctor bash Analyze all sessions (default) claude-doctor Analyze a specific session by ID claude-doctor <session-id> Analyze a specific JSONL file directly claude-doctor path/to/session.jsonl Filter to a named project claude-doctor -p myproject Generate rules for CLAUDE.md / AGENTS.md claude-doctor --rules Save model and guidance to .claude-doctor/ claude-doctor --save Output results as JSON (for piping/scripting) claude-doctor --json Combine flags claude-doctor -p myproject --rules --json bash claude-doctor --rules Rules (auto-generated by claude-doctor) Based on analysis of 838 sessions. Paste into your CLAUDE.md or AGENTS.md. Read the full file before editing. Plan all changes, then make ONE complete edit. After 2 consecutive tool failures, stop and change your approach entirely. When the user corrects you, stop and re-read their message. Complete the FULL task before stopping. Every few turns, re-read the original request to make sure you haven't drifted. bash claude-doctor --save markdown <!-- CLAUDE.md --> Project Rules <!-- Auto-generated diagnostics --> {{include .claude-doctor/guidance.md}} bash #!/bin/bash .claude/hooks/pre-session.sh cat .claude-doctor/guidance.md bash Pipe into jq for signal filtering claude-doctor --json jq '.signals[] select(.severity == "high")' Save report claude-doctor --json > session-report.json Check a specific project's signals claude-doctor -p myproject --json jq '.signals[].name' json { "sessions": 838, "project": "myproject", "signals": [ { "name": "edit-thrashing", "severity": "high", "count": 14, "description": "Same file edited 5+ times in one session" }, { "name": "correction-heavy", "severity": "medium", "count": 23, "description": "20%+ of user messages are corrections" } ], "sentiment": { "score": -0.42, "label": "negative" } } bash Full audit with saved model claude-doctor --save Review guidance cat .claude-doctor/guidance.md bash Generate …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills aradotso/claude-doctor-session-diagnostics