errors
Original：🇺🇸 English
Translated
Error pattern analysis and troubleshooting for Claude Code sessions. Use when handling errors, fixing failures, troubleshooting issues.
1installs
Sourceyonatangross/orchestkit
Added on
NPX Install
npx skill4agent add yonatangross/orchestkit errorsTags
Translated version includes tags in frontmatterSKILL.md Content
View Translation Comparison →Error Pattern Analysis
Analyze errors captured from Claude Code sessions to identify patterns and get actionable insights.
Quick Start
bash
/errors # Batch analysis of historical error patterns
/debug # CC 2.1.30 real-time debug for current sessionWhen to Use Which
| Command | Purpose | Scope |
|---|---|---|
| Batch analysis of error patterns (last 24h/7d) | Historical patterns |
| Real-time debug of current session state | Current session |
| Full RCA workflow for specific bug | Single issue |
Quick Analysis
bash
# Run batch analysis on last 24h of errors
python .claude/scripts/analyze_errors.py
# Analyze last 7 days
python .claude/scripts/analyze_errors.py --days 7
# Generate markdown report
python .claude/scripts/analyze_errors.py --reportWhat Gets Captured
The error collector hook captures:
- Tool name (Bash, mcp__memory__search_nodes, etc.)
- Error message (first 500 chars)
- Tool input (command/query that failed)
- Timestamp and session ID
Location:
.claude/logs/errors.jsonlCurrent Error Rules
Check learned patterns that trigger warnings:
bash
cat .claude/rules/error_rules.json | jq '.rules[] | {id, signature, count: .occurrence_count}'Files
| File | Purpose |
|---|---|
| Captures errors to JSONL |
| Warns before risky commands |
| Batch pattern analysis |
| Learned error patterns |
| Raw error log |
Common Patterns
PostgreSQL Connection Errors
pattern: role "X" does not exist
fix: Use Docker connection: docker exec -it orchestkit-postgres-dev psql -U orchestkit_user -d orchestkit_dev
pattern: relation "X" does not exist
fix: Check MCP postgres server connection string - may be connected to wrong databaseRelated Skills
- fix-issue: Fix identified errors
- debug-investigator: Debug error root causes
Adding New Rules
Rules are auto-generated by when patterns repeat 2+ times.
For manual rules, edit :
analyze_errors.py.claude/rules/error_rules.jsonjson
{
"id": "custom-001",
"pattern": "your regex pattern",
"signature": "human readable signature",
"tool": "Bash",
"occurrence_count": 1,
"fix_suggestion": "How to fix this"
}