rfc9457

Design and review RFC 9457 problem details error responses for HTTP APIs.

Updated Sep 9, 2026
One-click install
npx skills add https://github.com/DeepSpaceCartel/skills --skill rfc9457-deepspacecartel
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: rfc9457
Source: https://github.com/DeepSpaceCartel/skills/tree/main/skills/rfc9457
Command: npx skills add https://github.com/DeepSpaceCartel/skills --skill rfc9457-deepspacecartel

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? HTTP APIs often invent bespoke, inconsistent error response shapes that clients cannot parse reliably. This Skill provides the rules of RFC 9457 (Problem Details for HTTP APIs, obsoleting RFC 7807) so error bodies follow a standard, machine-readable format. ## Core Features & Use Cases - Standard error format: Defines the application/problem+json (and +xml) media type with the five core members: type, status, title, detail, and instance. - Extension members and custom problem types: Guides defining new problem types with documented type URIs, titles, status codes, and extension members such as validation error arrays. - Compliance review and security guidance: Covers the about:blank default, content negotiation, multiple-problem handling, and security risks like leaking stack traces or status field mismatches. - Use Case: When designing a REST API's 4xx/5xx responses, use this Skill to produce spec-compliant problem details JSON and review existing error payloads for RFC 9457 conformance. ## Quick Start Ask the AI to design an RFC 9457 problem details error response for your API's validation failure case, or to review an existing error JSON body for spec compliance.

Frequently Asked Questions about rfc9457

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

FAQPage Schema
How do I format HTTP API error responses with RFC 9457?▼

Return a JSON body with media type application/problem+json containing the members type, status, title, detail, and instance. All five are optional; an omitted type defaults to about:blank, meaning no semantics beyond the HTTP status code.

What is the difference between RFC 9457 and RFC 7807?▼

RFC 9457 obsoletes RFC 7807 but keeps the same media types and wire format, so existing RFC 7807 responses remain valid RFC 9457 responses. The update mainly clarifies guidance on extensions, security, and type definition.

How do I add custom fields to a problem details response?▼

Add extension members beyond the five core fields, documented by your problem type, such as an errors array with detail and pointer entries for validation failures. Consumers must ignore extensions they do not recognize, so types can evolve safely.

When should I not use problem details for an API error?▼

Avoid it when a bare status code already explains the condition, when the response is a normal resource representation, or when your API already has an application-specific error format. Never use it as a channel for stack traces or debugging internals.

Why must the status member match the HTTP status code?▼

The status member is advisory and exists only so consumers can recover the original code after an intermediary changes it. A mismatch signals that something in the path altered the response, so the two must never intentionally differ.