error-model-validation-architect

Design API validation and error-handling contracts for Kotlin and Spring services.

302|22|Updated Feb 12, 2026
One-click install
npx skills add https://github.com/JetBrains/skills --skill error-model-validation-architect-jetbrains
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: error-model-validation-architect
Source: https://github.com/JetBrains/skills/tree/main/error-model-validation-architect
Command: npx skills add https://github.com/JetBrains/skills --skill error-model-validation-architect-jetbrains

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Design and implement a consistent API validation and error-handling contract for Kotlin and Spring services, turning scattered exceptions into a public, machine-readable contract.

Core Features & Use Cases

  • Define a stable error taxonomy covering malformed input, not found, conflicts, authentication/authorization, downstream failures, and internal errors.
  • Establish explicit HTTP status mappings and a structured error payload to enable reliable client handling.
  • Provide practical guidance on integrating a central ControllerAdvice, mapping framework exceptions, and avoiding leakage of internal details.

Quick Start

Create or adopt a centralized error contract, document taxonomy and status codes, and implement a ControllerAdvice to enforce it across your Kotlin/Spring 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 design consistent API error handling in Spring and Kotlin?▼

Design consistent API error handling by defining a stable error taxonomy, explicit HTTP status mappings, and a structured error payload implemented through a central ControllerAdvice to enforce a uniform contract across all Kotlin and Spring endpoints.

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

The best way to map exceptions to HTTP status codes is by implementing a central ControllerAdvice that translates framework and application-specific exceptions into explicit HTTP status mappings, preventing internal-detail leakage and ensuring stable client contracts.

How do I prevent leaking internal details in API error responses?▼

Prevent leaking internal details in API error responses by adopting a structured, machine-readable error payload that covers common failure modes, ensuring your ControllerAdvice masks internal exceptions behind a stable public error taxonomy.

Does this error handling approach work for Kotlin and Spring services?▼

Yes, this approach works specifically for Kotlin and Spring services, providing targeted guidance on integrating ControllerAdvice and exception mapping to turn scattered exceptions into a public, machine-readable contract.

What should be included in an API error taxonomy for validation failures?▼

An API error taxonomy for validation failures should include categories for malformed input, not found, conflicts, authentication/authorization, downstream failures, and internal errors, each mapped to explicit HTTP status codes and a structured payload.

How do I standardize downstream error handling in Spring APIs?▼

Standardize downstream error handling in Spring APIs by defining a reusable error payload and integrating a central ControllerAdvice that maps downstream service failures into your established error taxonomy without leaking internal details.