error-handling-guide

What problem does it solve?

This Skill provides a cohesive framework for error handling in Go applications, enabling predictable error propagation, context-rich logging, and safe recovery.

Core Features & Use Cases

• Custom error types for domain errors
• Error wrapping with context using %w
• Structured logging and mapping errors to HTTP statuses
• Panic recovery and retry logic
• Error handling in goroutines and concurrent tasks
• Guidance on best practices and anti-patterns

Quick Start

Integrate the error-handling patterns into your Go services by defining domain errors, wrappers, and recovery middleware. Start by adding the custom error types and wrapping helpers to your service layer, wire MapErrorToHTTPStatus in your HTTP handlers, and enable PanicRecoveryMiddleware and Retry helpers where appropriate.