error-handling-standardizer — скилл для Claude Code: обработка ошибок
Скилл error-handling-standardizer помогает привести ошибки приложения к общей схеме: от собственных классов до HTTP-ответов и структурированных логов. Пригодится при пересмотре обработки исключений в API.
MIT 269 установок ★ 64 обновлён 2026-01-12
npx skills add patricio0312rev/skills --skill error-handling-standardizer -a claude-codeЧто делает error-handling-standardizer
Скилл предлагает классы AppError, ValidationError, NotFoundError, UnauthorizedError и ForbiddenError, а также middleware для обработки ошибок. Известные операционные ошибки получают заданный HTTP-статус и код; для неизвестных ошибок возвращается общий ответ 500 с идентификатором запроса. Клиенту не отправляется stack trace.
В примерах используются TypeScript-типы Express и winston: логгер записывает сообщение, stack trace и контекст запроса, а asyncHandler передаёт ошибки из асинхронных маршрутов в middleware. Неизвестная ошибка приведёт к ответу 500, поэтому проверьте, что такой общий ответ подходит вашему API.
Какие задачи решает
- разделить ошибки валидации и программные сбои
- сопоставить типы ошибок с HTTP-статусами
- возвращать безопасные сообщения клиенту
- добавить контекст запроса в логи
- передавать ошибки асинхронных маршрутов в middleware
Примеры запросов агенту
- Приведи обработку ошибок в API к общей схеме с классами и HTTP-статусами.
- Добавь middleware, который скрывает внутренние ошибки от клиента и пишет контекст запроса в лог.
- Проверь асинхронные маршруты и оберни их в общий обработчик ошибок.
Как установить error-handling-standardizer
1Через Skills CLI (Vercel)
npx skills add patricio0312rev/skills --skill error-handling-standardizer -a claude-code2Вручную: положить файлы
~/.claude/skills/error-handling-standardizer/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/error-handling-standardizer/
1Через Skills CLI (Vercel)
npx skills add patricio0312rev/skills --skill error-handling-standardizer -a codex2Вручную: положить файлы
.agents/skills/error-handling-standardizer/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add patricio0312rev/skills --skill error-handling-standardizer -a cursor2Вручную: положить файлы
.cursor/skills/error-handling-standardizer/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install patricio0312rev/skills backend/error-handling-standardizer/SKILL.md2Вручную: положить файлы
.github/skills/error-handling-standardizer/SKILL.md1Через Skills CLI (Vercel)
npx skills add patricio0312rev/skills --skill error-handling-standardizer -a gemini-cli2Командой платформы
gemini skills install https://github.com/patricio0312rev/skills --path backend/error-handling-standardizerВручную: положить файлы
.devin/skills/error-handling-standardizer/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add patricio0312rev/skills --skill error-handling-standardizer -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы об error-handling-standardizer
Как установить error-handling-standardizer в Claude Code?
Выполните npx skills add patricio0312rev/skills --skill error-handling-standardizer -a claude-code. Файл скилла находится по пути ~/.claude/skills/error-handling-standardizer/SKILL.md.
Что делает error-handling-standardizer?
Помогает унифицировать классы ошибок, HTTP-ответы и структурированные логи. Также показывает middleware и обёртку для ошибок асинхронных маршрутов.
Как скилл обрабатывает неизвестные ошибки?
Middleware возвращает HTTP 500 с общим сообщением и идентификатором запроса. Stack trace записывается в лог, но не отправляется клиенту.
Исходный текст
SKILL.md · MIT
---
name: error-handling-standardizer
description: Creates consistent error handling with custom error classes, HTTP status mapping, structured logging, safe client messages, and error taxonomy. Use when standardizing "error handling", "logging", "error responses", or "exception management".
---
# Error Handling Standardizer
Build consistent, debuggable error handling across the application.
## Error Taxonomy
```typescript
export class AppError extends Error {
constructor(
public code: string,
public message: string,
public statusCode: number = 500,
public isOperational: boolean = true,
public details?: any
) {
super(message);
Error.captureStackTrace(this, this.constructor);
}
}
export class ValidationError extends AppError {
constructor(details: Record<string, string[]>) {
super("VALIDATION_ERROR", "Validation failed", 400, true, details);
}
}
export class NotFoundError extends AppError {
constructor(resource: string) {
super("NOT_FOUND", `${resource} not found`, 404);
}
}
export class UnauthorizedError extends AppError {
constructor(message = "Unauthorized") {
super("UNAUTHORIZED", message, 401);
}
}
export class ForbiddenError extends AppError {
constructor(message = "Forbidden") {
super("FORBIDDEN", message, 403);
}
}
```
## Error Handler Middleware
```typescript
export const errorHandler = (
err: Error,
req: Request,
res: Response,
next: NextFunction
) => {
// Log error
logger.error("Request error", {
error: err.message,
stack: err.stack,
path: req.path,
method: req.method,
requestId: req.id,
});
// Operational errors (known)
if (err instanceof AppError && err.isOperational) {
return res.status(err.statusCode).json({
success: false,
error: {
code: err.code,
message: err.message,
details: err.details,
trace_id: req.id,
},
});
}
// Programming errors (unknown)
return res.status(500).json({
success: false,
error: {
code: "INTERNAL_ERROR",
message: "An unexpected error occurred",
trace_id: req.id,
},
});
};
```
## Structured Logging
```typescript
import winston from "winston";
export const logger = winston.createLogger({
level: "info",
format: winston.format.combine(
winston.format.timestamp(),
winston.format.errors({ stack: true }),
winston.format.json()
),
transports: [
new winston.transports.File({ filename: "error.log", level: "error" }),
new winston.transports.File({ filename: "combined.log" }),
],
});
// Log with context
logger.error("Payment processing failed", {
userId: user.id,
amount: payment.amount,
error: err.message,
trace_id: req.id,
});
```
## Safe Client Messages
```typescript
// Never expose internal errors to clients
const getSafeErrorMessage = (err: Error): string => {
if (err instanceof AppError && err.isOperational) {
return err.message; // Safe, user-facing message
}
// Generic message for unexpected errors
return "An unexpected error occurred";
};
```
## Async Error Handling
```typescript
// Wrap async routes
export const asyncHandler = (fn: RequestHandler) => {
return (req: Request, res: Response, next: NextFunction) => {
Promise.resolve(fn(req, res, next)).catch(next);
};
};
// Usage
router.get(
"/users",
asyncHandler(async (req, res) => {
const users = await userService.findAll();
res.json(users);
})
);
```
## Best Practices
- Use custom error classes
- Distinguish operational vs programming errors
- Log all errors with context
- Never expose stack traces to clients
- Include trace IDs for debugging
- Monitor error rates by type
- Set up alerting for critical errors
## Output Checklist
- [ ] Custom error classes defined
- [ ] Error handler middleware
- [ ] HTTP status code mapping
- [ ] Structured logging setup
- [ ] Safe client error messages
- [ ] Async error wrapper
- [ ] Error monitoring/alerts
- [ ] Documentation of error codes
© patricio0312rev · MIT · patricio0312rev/skills