| name | log-tool-failure |
| description | If any tool call fails, log it IMMEDIATELY with this skill |
Append one VALID JSON object per unexpected, reusable tool failure to ~/Documents/data/agents/tool-failure.jsonl. Quote / escape JSON programmatically.
{
"timestamp": "...",
"agent": "codex",
"path": "/home/sanand/...",
"session": "...",
"summary": "...",
"request": {},
"response": {}
}
Log only failures that can improve future agent behavior:
- recurring command misuse
- local environment/tool limitation
- dependency/auth/permission/rate-limit blocker
- brittle selector/API/version mismatch
- failed logging or failed recovery mechanism
- non-obvious test/tool behavior that caused rework
Skip:
- expected failing tests in TDD
- deliberate negative tests
- ordinary no-match searches
- user-approved skipped work
- project/content/process mistakes better suited to post-mortem