A specialized diagnostic tool for identifying non-idiomatic error handling and swallowed errors in Go codebases.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install go-error-handler
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install go-error-handler using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Go Error Handler Analyzer?
The Go Error Handler Analyzer is a comprehensive diagnostic tool designed to help developers maintain high-quality codebases by auditing error management logic. By utilizing this skill within Openclaw Skills, teams can systematically detect critical failures such as ignored return values, missing context in error wrapping, and fragile type assertions. It ensures that projects adhere to Go proverbs and standard library conventions, significantly reducing the risk of silent production failures.
This analyzer goes beyond simple linting by looking at the logical lifecycle of errors, from discovery in the go.mod file to complex propagation patterns in goroutines and HTTP handlers. It provides a structured approach to technical debt reduction by highlighting exactly where error chains are broken and how to fix them using modern Go features like the %w verb and the errors package functionality.
Go Error Handler Analyzer Use Cases
- Auditing legacy Go repositories to identify and fix silently swallowed errors that cause intermittent bugs.
- Enforcing idiomatic error wrapping conventions during automated code reviews or pre-merge checks.
- Securing HTTP handlers by detecting internal error leakage to external clients.
- Standardizing error handling across microservices by migrating from direct equality checks to errors.Is and errors.As patterns.
How Go Error Handler Analyzer Works
- Performs project discovery by analyzing go.mod to determine the Go version and identify any third-party error libraries in use.
- Executes recursive scans to find swallowed errors where return values are explicitly ignored with underscores or assigned but never checked.
- Audits error wrapping logic to ensure that call-site context is preserved using %w instead of losing the error chain with %v.
- Identifies fragile sentinel error patterns and type assertions that break when errors are wrapped.
- Inspects concurrency and networking code for missing error propagation in goroutines and incomplete HTTP handler responses.
- Generates a prioritized Markdown report within Openclaw Skills that categorizes findings by severity with specific code locations and remediation steps.
Go Error Handler Analyzer Setup
To deploy this skill, ensure your environment has standard Unix utilities available. Navigate to your Go project root and initialize the analysis with these commands:
# Check project dependencies and Go version
cat go.mod | head -10
# Scan for common swallowed error patterns
grep -rn '\\b_\\s*=.*(' --include="*.go" . | grep -v 'vendor/'
You can then run specific checks for error wrapping or sentinel usage as defined in the skill logic.
Go Error Handler Analyzer Data Schema & Taxonomy
The analyzer organizes its findings into a structured report to facilitate quick remediation. The data is typically organized as follows:
| Data Point | Description |
|---|---|
| Critical Findings | Highlights ignored errors in DB, I/O, or network calls and internal leaks. |
| Wrapping Audit | A table mapping file locations to incorrect wrapping verbs like %v or %s. |
| Sentinel Inventory | Tracks the usage of sentinel errors and whether they are checked idiomaticaly. |
| Recommendations | A summary of total instances requiring refactoring to meet Go conventions. |
Go Error Handler Analyzer Advanced Features
- Multi-library support: Detects and analyzes usage of pkg/errors, multierr, and cockroachdb/errors.
- Security auditing: Identifies instances where raw error strings are leaked through http.Error calls.
- Goroutine safety: Checks for missing error propagation in background tasks and improper errgroup usage.
- Test coverage analysis: Automatically identifies packages that lack error-path testing or use generic error assertions.
SKILL.md
Loading
Related Openclaw Skills
Portal Token Discovery
A specialized skill for AI agents to retrieve canonical token identifiers, trusted market links, and real-time pricing for the PORTAL token.
GraphQL Schema Analyzer
A comprehensive auditing tool to detect performance bottlenecks, security vulnerabilities, and design anti-patterns in GraphQL schemas.
GitLab CI Optimizer
A specialized tool for analyzing and refactoring GitLab CI/CD configurations to maximize execution speed and minimize compute costs.
Medication Questions Prep
A professional communication tool designed to help patients structure and organize critical questions for clinicians and pharmacists regarding their medication regimens.
Doctor Visit Prep
A professional communication framework designed to help patients organize symptom timelines, prioritize clinical questions, and manage post-appointment follow-ups.
Heart-Healthy Grocery Guide
A specialized health literacy tool designed to help users interpret nutrition labels and build heart-healthy grocery lists.
Featured*
