error-auditlisted
Install: claude install-skill arndvs/ctrlshft
# Error Audit
If running interactively (human present), output "Read Error Audit skill." to acknowledge. If running with --dangerously-skip-permissions (AFK/unattended), skip acknowledgement and proceed directly.
Scan every Claude Code session transcript for errors, cluster by root cause, surface the top offenders with suggested remediations.
---
## When to invoke
- Periodically (every 5-10 sessions) as a health check
- When the user notices "this keeps happening"
- After a session with 3+ retry loops on the same error
- When proposing a new hook or rule (to justify it with data)
---
## Usage
```bash
# Default: all sessions, top 20 clusters, human output
python3 skills/error-audit/error-audit.py
# Last 30 days only
python3 skills/error-audit/error-audit.py --since 30
# Show fewer clusters
python3 skills/error-audit/error-audit.py --top 10
# Machine-readable (for piping into other tools)
python3 skills/error-audit/error-audit.py --json
# Override the projects dir (useful for testing)
python3 skills/error-audit/error-audit.py --projects-dir /path/to/projects
# Override or disable suppressions
python3 skills/error-audit/error-audit.py --suppressions-path /path/to/suppressions.md
python3 skills/error-audit/error-audit.py --no-suppressions
python3 skills/error-audit/error-audit.py --show-suppressed
```
## Steps (when invoking via `/error-audit`)
1. Run `python3 <skill-path>/error-audit.py` with any arguments the user provided.
2. Display the output to the user exact