What is the primary benefit of the AppError class?

AppError provides a typed structure for errors, allowing you to attach programmatic error codes, debug context, and metadata like 'recoverable' status for better UI handling.

Can I extend the existing error codes?

Absolutely. You can add new members to the ErrorCode enum and update the friendly message mapping to support new application features.

How are technical errors converted for end users?

The framework uses a toUserMessage() utility that maps specific ErrorCodes to friendly, non-technical instructions, such as converting UPLOAD_TOO_LARGE to a file size warning.

Does this skill work on both frontend and backend?

Yes, it includes specific patterns for client-side reporting (toasts and console) and server-side logging (Vercel logs and monitoring services).

How does error normalization work?

The normalizeError utility takes any unknown caught object and ensures it is wrapped in an AppError instance, preventing crashes when interacting with non-standard error objects.

Centralized Error Handling Framework

Name: Centralized Error Handling Framework
Author: vassovass

byvassovass

•

API 开发

Implements a robust, typed error management system for consistent exception handling, reporting, and user feedback.

The Error Handling skill provides a standardized framework for managing exceptions across the StepLeague ecosystem. By utilizing a custom AppError class and a comprehensive ErrorCode enum, it ensures that every failure—from API requests to database queries—is captured with rich context and type safety. This skill enables developers to implement defensive programming patterns that automatically normalize unknown errors, log issues to the server, and provide user-friendly messaging via toast notifications, significantly improving both developer productivity and the end-user experience.

主要功能

01Custom AppError class for typed exceptions with context and recovery flags

021 GitHub stars

03Standardized ErrorCode enum covering API, DB, Uploads, and Validation

04Automated error normalization to transform any exception into a manageable format

05Human-readable message mapping for technical error codes

06Dual-environment reporting for both client-side UI and server-side logging

使用场景

01Capturing detailed debugging context in server-side logs without exposing sensitive data

02Implementing graceful recovery flows for network or file upload errors

03Standardizing API response failures with specific HTTP status mapping

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add vassovass/scl-v3 error-handling

For use in Claude.ai and ChatGPT

Download Skill