error-model-validation-architect

Design a consistent API error model for Kotlin and Spring services.

14|1|Updated Mar 6, 2026
One-click install
npx skills add https://github.com/kbrgnj/kotlin-backend-agent-skills --skill error-model-validation-architect-kbrgnj
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: error-model-validation-architect
Source: https://github.com/kbrgnj/kotlin-backend-agent-skills/tree/main/.agents/skills/error-model-validation-architect
Command: npx skills add https://github.com/kbrgnj/kotlin-backend-agent-skills --skill error-model-validation-architect-kbrgnj

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The Skill helps teams design and implement a consistent API error model for Kotlin + Spring services, preventing leakage of internal details and providing stable, machine-readable error semantics.

Core Features & Use Cases

  • Standardized error taxonomy that categories common failures (malformed requests, not found, conflicts, authentication, and downstream errors).
  • Controller advice alignment with durable error payloads, safe exposure of internal details, and traceable correlation IDs.
  • Use cases include public APIs, internal services, and partner integrations, ensuring predictable error behavior.

Quick Start

Define and apply a standard API error contract to your Kotlin + Spring REST endpoints.

Frequently Asked Questions about error-model-validation-architect

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I standardize API error responses in a Kotlin Spring application?

Standardize API error responses in a Kotlin Spring application by defining a consistent error taxonomy and using controller advice to map domain and framework exceptions to durable, machine-readable payloads with traceable correlation IDs.

What is the best way to map domain exceptions to HTTP status codes in Spring?

Mapping domain exceptions to HTTP status codes in Spring requires a structured error taxonomy that categorizes failures like malformed requests, conflicts, and downstream errors into predictable, standardized status mappings across all endpoints.

How does controller advice prevent leakage of internal details in API errors?

Controller advice prevents leakage of internal details by intercepting framework and domain exceptions, ensuring safe exposure limits and returning standardized, stable error payloads instead of raw stack traces to clients.

Can I use this API error model for internal services and partner integrations?

Yes, this API error model applies to public APIs, internal services, and partner integrations, providing predictable error behavior and stable semantics across various integration contexts.

Why do I need a structured error taxonomy for REST endpoint validation?

A structured error taxonomy for REST endpoint validation categorizes common failures like malformed requests, not found, and authentication errors, providing machine-readable semantics and preventing unpredictable error behavior.