Agent skill · data analytics · yonatangross
errors
Claude Code session error triage: categorizes network, auth, model, tool and permission errors, finds prior occurrences, suggests recovery. Use when a session hits errors or failures.
Why this skill is useful
Provides specific error patterns and resolution steps that the AI wouldn't reliably generate on its own.
What it needs
Requires jq, python installed locally. About 2k tokens when loaded. Last updated 2026-08-06. 215 stars on the source repository.
What this skill does
Error Pattern Analysis Analyze errors captured from Claude Code sessions to identify patterns and get actionable insights. Quick Start When to Use Which Command Purpose Scope --------- --------- ------- /errors Batch analysis of error patterns (last 24h/7d) Historical patterns /debug Real-time debug of current session state Current session fix-issue Full RCA workflow for specific bug Single issue CC 2.1.169+: for errors that survive /clear and restarts, claude --safe-mode boots with every customization disabled (CLAUDE.md/plugins/skills/hooks/MCP) — the one-step test that separates "ork/hook/MCP bug" from "CC bug" before deeper analysis. Quick Analysis What Gets Captured The error collector hook captures: Tool name (Bash, mcpmemorysearchnodes, etc.) Error message (first 500 chars) Tool input (command/query that failed) Timestamp and session ID Location: .claude/logs/errors.jsonl Current Error Rules Check learned patterns that trigger warnings: Files File Purpose ------ --------- .claude/hooks/posttool/error-collector.sh Captures errors to JSONL .claude/hooks/pretool/bash/error-pattern-warner.sh Warns before risky commands .claude/scripts/analyzeerrors.py Batch pattern analysis .claude/rules/errorrules.json Learned error patterns .claude/logs/errors.jsonl Raw error log Common Patterns Connection Refused / Wrong Port PostgreSQL Connection Errors Hook Errors (CC 2.1.98) Since CC 2.1.98, hook errors show the first line of stderr directly in the transcript — no need for --debug: Related Skills ork:fix-issue: Fix identified errors debug-investigator: Debug error root causes Adding New Rules Rules are auto-generated by analyzeerrors.py when patterns repeat 2+ times. For manual rules, edit .claude/rules/errorrules.json:
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills yonatangross/errors--e473e7