Borrowing it
Nothing to install: this file belongs to chacosoldier/compabob. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.
curl -O https://raw.githubusercontent.com/chacosoldier/compabob/main/.claude/agents/error-handling.mdgit clone --depth 1 https://github.com/chacosoldier/compabobWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/agents/chacosoldier/compabob/error-handling)<a href="https://agentmods.dev/agents/chacosoldier/compabob/error-handling"><img src="https://agentmods.dev/badge/agents/chacosoldier/compabob/error-handling/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/agents/chacosoldier/compabob/error-handling"><img src="https://agentmods.dev/badge/agents/chacosoldier/compabob/error-handling.svg" alt="Reviewed on agentmods" width="80" height="20"></a>What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.00000 | $0.00910 |
| Opus 5.5 | $0.00000 | $0.00364 |
| Sonnet 5.5 | $0.00000 | $0.00182 |
| Haiku 4.5 | $0.00000 | $0.00091 |
Grade A, and why
error-handling scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 1mo ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 78 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Error Handling (shared across agents)
Every agent follows these patterns when something fails. Reference this file from each agent's instructions.
Read-Before-Speak gate (stakes-sensitive agents)
For any agent whose wrong output drives a wrong real-world action (a financial figure, a legal claim, a commitment in a draft), apply a hard structural gate at the top of the agent file:
- Read the named source files BEFORE producing output that cites a number, fact, or recommendation.
- Declare what was loaded at the top of the response:
Context loaded: [list]. - If a required read fails, STOP and report the missing source. Do not substitute general knowledge or stale memory.
This is stronger than a self-check at the bottom of a file, which the model may skim past.
Error classification
| Type | Examples | Action |
|---|---|---|
| Transient | Timeout, rate limit, 429/503/504 | Retry once after 5s. If it fails again, tell the user and suggest retrying later. |
| Auth | 401, expired token, permission denied | Do NOT retry. Tell the user which service needs re-authentication. |
| Data | Empty result, unexpected schema, null fields | Check the query syntax. If the query is valid, report "no data found" with the query used. |
| Semantic | Query returns wrong-looking numbers, request misinterpreted | Self-check before presenting. Flag: "These numbers look unusual, please verify." |
| Not found | Record or file does not exist | Confirm the name or ID with the user before retrying with a different search. |
Never retry: auth errors, permission errors, not-found errors, validation errors. Always retry once: timeouts, rate limits, service-unavailable, connection reset.
Fallback chains
When a primary source is unavailable, fall back and say so:
- An external connector fails → work from local files; note "[connector] unavailable, working from cached data".
- A search index fails → fall back to plain
Grep; note that results are keyword-only. - A notification channel fails → log the action locally so it is not lost.
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 1mo ago First seen · 78 lines · 0 tokens per session scan A 71c9bfc23779
error-handling is an agent published in the GitHub repository chacosoldier/compabob (34 stars, last pushed 5d ago), licensed MIT. It costs nothing until one of its globs matches a file; then it loads 910 tokens. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.
Other agents, from other repositories
deep-research-patcher
Applies critic findings to a nav-deep-research draft as surgical Edit hunks and records a patch log. Tool-locked so it cannot regenerate the report. Spawned once at step 5 by the nav-deep-research skill.
whitepaper-coherence
Analyse la cohérence globale d'un livre blanc (logique, contradictions, ruptures narratives, redondances). Utiliser pour auditer un whitepaper avant publication.
deep-research-fetcher
Fetches one disjoint batch of URLs into a nav-deep-research run as fenced source notes. Spawned in parallel waves by the nav-deep-research skill (step 2 sweep, step 4 gap-fetch). Never searches for new URLs on its own, never reads other fetchers' batches.
stock-balance-sheet-reviewer
Specialist for US-stock balance-sheet health review — leverage (Net Debt/EBITDA), liquidity (current ratio, cash runway), goodwill concentration and impairment history, working capital trends (DSO, inventory days), off-balance-sheet items (commitments, contingencies), and pension underfunding. Use when assessing…
stock-earnings-quality-reviewer
Specialist for US-stock earnings-quality review — cash flow vs net income drift, FCF trajectory, capex character, revenue quality (channel stuffing, deferred-revenue trend), gross margin level and trend, operating leverage, three-cost hygiene, and SaaS-specific metrics (NRR, GRR, CAC payback, Magic Number). Use when…
go-security-reviewer
Go security vulnerability reviewer covering OWASP Top 10, injection (SQL/command/path traversal), auth/authz bypass, crypto misuse, secrets exposure, SSRF, and input validation. Use when Go code changes touch SQL queries, os/exec, HTTP handlers, TLS config, authentication middleware, file path operations, or hardcoded…