christopherlouet/claude-base / .claude/skills/dev-error-handling
dev-error-handling
VerifiedError handling strategy. Trigger when the user wants to implement error handling, exceptions, or error boundaries.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 2.2 KB |
| examples/error-boundary.md | markdown | 3.2 KB |
examples/error-boundary.md
View on GitHub# Example: Error Handling Patterns
## Scenario
A Node.js API needs structured error handling: custom error classes, middleware, and client-friendly responses.
## Custom Error Hierarchy
```typescript
// src/errors/base.ts
export class AppError extends Error {
constructor(
message: string,
public readonly code: string,
public readonly statusCode: number,
public readonly details?: Record<string, unknown>,
) {
super(message);
this.name = this.constructor.name;
}
}
export class ValidationError extends AppError {
constructor(message: string, details?: Record<string, unknown>) {
super(message, 'VALIDATION_ERROR', 400, details);
}
}
export class NotFoundError extends AppError {
constructor(resource: string, id: string) {
super(`${resource} with id ${id} not found`, 'NOT_FOUND', 404);
}
}
export class ConflictError extends AppError {
constructor(message: string) {
super(message, 'CONFLICT', 409);
}
}
```
## Error Middleware
```typescript
// src/middleware/error-handler.ts
import { logger } from '@/lib/logger';
export function errorHandler(err: Error, req: Request, res: Response, next: NextFunction) {
if (err instanceof AppError) {
// Known errors: log at warn, return structured response
logger.warn({ err, requestId: req.id }, err.message);
return res.status(err.statusCode).json({
success: false,
error: { code: err.code, message: err.message, details: err.details },
});
}
// Unknown errors: log at error, return generic 500
logger.error({ err, requestId: req.id }, 'Unhandled error');
res.status(500).json({
success: false,
error: { code: 'INTERNAL_ERROR', message: 'An unexpected error occurred' },
});
}
```
## Usage in Service
```typescript
// src/services/user.service.ts
export class UserService {
async getById(id: string): Promise<User> {
const user = await this.db.user.findUnique({ where: { id } });
if (!user) throw new NotFoundError('User', id);
return user;
}
async create(input: CreateUserInput): Promise<User> {
const existing = await this.db.user.findByEmail(input.email);
if (existing) throw new ConflictError('Email already registered');
return this.db.user.create({ data: input });
}
}
```
## React Error Boundary (Frontend)
```tsx
// components/ErrorBoundary.tsx
class ErrorBoundary extends React.Component<Props, { error: Error | null }> {
state = { error: null };
static getDerivedStateFromError(error: Error) { return { error }; }
componentDidCatch(error: Error, info: React.ErrorInfo) {
reportError(error, info.componentStack); // Send to Sentry/logging
}
render() {
if (this.state.error) return <ErrorFallback error={this.state.error} onRetry={() => this.setState({ error: null })} />;
return this.props.children;
}
}
```
## Key Decisions
- **Error hierarchy**: `AppError` base class enables consistent handling via `instanceof`
- **Separate known vs unknown**: Known errors get specific status codes, unknown get 500
- **No stack traces to client**: Internal details logged server-side, never exposed
- **Error codes over messages**: Clients use `code` field for programmatic handling
- **Error boundary on frontend**: Catches render errors, reports to monitoring, shows fallback UI
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |