How does the skill ensure it uses the latest JSON:API version?

It includes instructions to validate rules against the live specification using Context7 MCP or WebFetch, ensuring compliance even as the spec evolves.

Can it help with relationship updates?

Yes, it provides specific patterns for to-one and to-many relationship updates, including POST, PATCH, and DELETE operations for resource linkage.

What are some common violations this skill prevents?

It prevents common mistakes such as using integer IDs, camelCase types, including foreign keys in attributes, or returning both data and errors in a single response.

Does this skill handle implementation in specific frameworks?

This skill focuses on the specification's requirements (MUST/MUST NOT rules). For implementation patterns in frameworks like Django REST Framework, it is designed to be used alongside the django-drf skill.

JSON:API Specification Compliance

Name: JSON:API Specification Compliance
Author: BrunoAlan

byBrunoAlan

0•

API 开发

Ensures strict adherence to the JSON:API v1.1 specification when building, modifying, or reviewing API endpoints.

This skill provides a comprehensive set of rules and patterns to maintain full compliance with the JSON:API v1.1 standard. It enforces critical document structures, mandatory HTTP status codes, and resource relationship formats while preventing common violations like mixed data/error objects or incorrect ID types. Ideal for developers building standardized RESTful services, it integrates seamlessly with framework-specific skills like django-drf to ensure both architectural correctness and spec-perfect implementation through automated validation and real-time spec fetching.

主要功能

01Automated enforcement of resource object naming conventions and ID string requirements

020 GitHub stars

03Standardized HTTP status code mapping for success, error, and async operations

04Strict validation of JSON:API v1.1 document structure and media types

05Real-time spec verification using Context7 MCP or WebFetch fallback

06Guidance on complex relationship updates and compound document (include) logic

使用场景

01Designing new API endpoints that require strict JSON:API compliance

02Refactoring legacy REST APIs to follow the JSON:API v1.1 standard

03Auditing existing API responses for spec violations and schema consistency

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add brunoalan/agents-skills jsonapi

For use in Claude.ai and ChatGPT

Download Skill