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.