silent-failure-hunter
Skill4 starsChanged 7 months agoMITView on GitHub
Audits error handling for silent failures, inadequate user feedback, and unjustified fallback behavior. Finds issues in catch blocks, fallbacks, and error paths. Use after modifying error handling code.
3 other projects use a version of this, 2 of them edited.
Adopted by
Most recently taken up by
- PaulKinlan/Co-doedited, first seen Oct 8, 2026
- neronain/ClaudeSkills-Neronainedited, first seen Aug 9, 2026
- kumaran-is/claude-code-onboardingtheir own version, first seen May 25, 2026
Other versions3 projects use a version of this.
Word for word · 0
None found.
Edited · 2
- PaulKinlan/Co-do★ 7814% same
- neronain/ClaudeSkills-Neronain★ 314% same
Wrote their own version · 1
- kumaran-is/claude-code-onboarding★ 35same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository15 other files it gives its agents.
- AGENTS.mdAGENTS.md
- code-reviewSkill
- code-simplifierSkill
- comment-analyzerSkill
- conventions-improverSkill
- feature-devSkill
- frontend-designSkill
- frontend-layoutSkill
- gh-address-commentsSkill
- gh-fix-ciSkill
- mcp-server-devSkill
- review-toolkitSkill
- security-threat-modelSkill
- test-analyzerSkill
- type-design-analyzerSkill
The file
We split this skill into the rules it gives an agent
5 rules. 3 are common, 2 are distinctive, and 0 are very specific to this project.
3
Common
Most of the 3 edited versions we read keep these.
2
Distinctive
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 26
All try/catch blocks
- Common: line 27
All error callbacks and error event handlers
- Common: line 28
All conditional branches that handle error states
- Common: line 29
All fallback logic and default values used on failure
- Distinctive: line 44
Error propagation: Should this error propagate to a higher-level handler?
“Common” is measured: kept by at least 6 in 10 of the 3 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Silent Failure Hunter
Audit error handling code for silent failures, inadequate user feedback, and unjustified fallback behavior. Every error that occurs without proper logging and user notification is a critical defect.
Core Principles (non-negotiable)
- Silent failures are unacceptable — any error without proper logging and user notification is a critical defect.
- Users deserve actionable feedback — every error message must tell users what went wrong and what they can do.
- Fallbacks must be explicit and justified — silently falling back to alternative behavior hides problems.
- Catch blocks must be specific — broad exception catching hides unrelated errors and makes debugging impossible.
- Mock/fake implementations belong only in tests — production fallbacks to mocks indicate architectural problems.
Review Process
1. Identify All Error Handling Code
Systematically locate:
- All try/catch blocks
- All error callbacks and error event handlers
- All conditional branches that handle error states
- All fallback logic and default values used on failure
- Optional chaining (
?.) used in error handlers or callbacks where errors should be explicitly handled (not general null-safe property access)
2. Scrutinize Each Error Handler
For every error handling location:
Logging quality: Is the error logged with appropriate severity and context? Would this log help debug the issue months from now?
User feedback: Does the user receive clear, actionable feedback? Is the error message specific enough to be useful?
Catch block specificity: Does the catch block catch only the expected error types? List every unexpected error type that could be accidentally suppressed.
Fallback behavior: Is the fallback explicitly justified? Does it mask the underlying problem? Would the user be confused by the fallback rather than seeing an error?
Error propagation: Should this error propagate to a higher-level handler? Is it being swallowed when it should bubble up?
3. Check for Hidden Failure Patterns
- Empty catch blocks (forbidden)
- Catch blocks that only log and continue without user feedback
- Returning null/undefined/default values on error without logging
- Optional chaining (
?.) used in contexts where an error should be handled explicitly rather than silently skipped - Retry logic that exhausts attempts without informing the user
Output Per Issue
- Location: file path and line number
- Severity: CRITICAL (silent failure, broad catch) / HIGH (poor error message, unjustified fallback) / MEDIUM (missing context)
- Issue: what's wrong and why it's problematic
- Hidden errors: specific error types that could be suppressed
- User impact: how this affects debugging and user experience
- Recommendation: specific code changes with example corrected code
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

