error-model-validation-architect

Official

Design safe, predictable API errors.

AuthorKotlin
Version1.0.0
Installs0

System Documentation

What problem does it solve?

Design and implement consistent API validation and error-handling behavior for Kotlin plus Spring services. Use when defining error payloads, mapping framework and domain exceptions, standardizing HTTP status codes, adding @ControllerAdvice, preventing internal-detail leakage, or ensuring clients can rely on stable machine-readable error semantics across endpoints.

Core Features & Use Cases

  • Establish a stable error taxonomy covering malformed input, not found, conflicts, authentication, authorization, and downstream failures.
  • Map errors to explicit HTTP status codes and a machine-readable payload with a consistent contract.
  • Provide a centralized error handling strategy using a ControllerAdvice and documented guidelines for developers.
  • Use cases include API design-time contracts, auditing and observability of errors, and safe error responses for public endpoints.

Quick Start

Define and implement a stable, machine-readable API error contract for a Kotlin + Spring service, including error taxonomy, status mappings, and a ControllerAdvice-based handler.

Dependency Matrix

Required Modules

None required

Components

Standard package

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: error-model-validation-architect
Download link: https://github.com/Kotlin/kotlin-backend-agent-skills/archive/main.zip#error-model-validation-architect

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.