Inventory and simplify exception hierarchies and error returns during code reviews.
npx skills add https://github.com/codybrom/clairvoyance --skill error-design
Please help me install this Agent Skill. Skill: error-design Source: https://github.com/codybrom/clairvoyance/tree/main/skills/error-design Command: npx skills add https://github.com/codybrom/clairvoyance --skill error-design
This Skill helps developers reduce unnecessary exception complexity and prevent error handling from becoming a burdensome part of a module's interface.
Ask the error-design skill to review the error handling and exception surface of the specified file or module.
High-intent search queries and answers about installing and using this skill.
To simplify error handling, inventory all exceptions and error returns, then evaluate whether each can be defined out of existence, masked safely, aggregated, or promoted to centralized recovery to reduce caller burden.
Review exception design when callers handle numerous exceptions, catch blocks only log and rethrow, or error-handling code exceeds the length of the happy path, indicating excessive module complexity and recovery burden.
The best way to evaluate API exception complexity is assessing how exception handling affects module depth, caller responsibilities, and recovery behavior to determine if failure cases can be safely masked or aggregated.
Yes, during a code review you can define errors out of existence by inventorying thrown exceptions and error returns, then evaluating whether each failure case can be safely masked, aggregated, or allowed to crash.
Error handling code exceeds the main path when a module exposes excessive failure cases and exception types to callers, requiring simplification through aggregation, safe masking, or centralized recovery mechanisms.
Yes, this approach works for nested exception hierarchies by assessing how exception handling affects module depth and caller responsibilities, promoting top-level recovery to reduce exposed interface burden.
andresdiegolandaDefine domain-specific exceptions and a global handler for HTTP error mapping.
ahravReview Rust interfaces for ease of correct use and resistance to misuse.
rodrigo-altissimoAnalyze code complexity and propose deep-module refactoring steps.
zebbernImplement Python error-handling patterns for input validation and exception management.
