Skills
.Work. You
Rest

openapi-schemas

Official

Enforce clean, reusable OpenAPI schemas

Software Engineering#openapi#validation#composition#schemas#api-design#json-schema#nested-objects
Authorzerobias-org
Version1.0.0
Installs0

System Documentation

What problem does it solve?

OpenAPI schema design often drifts from core rules, leading to inconsistent response mappings, inline objects, and duplicated definitions. This Skill codifies rules 14-24 to ensure stable, reusable schemas across APIs.

Core Features & Use Cases

  • Direct main object mapping: ensure responses reference main business objects via $ref.
  • Context separation: split summary and full schemas to optimize nested vs direct responses.
  • Nested object discipline: enforce all nested objects use $ref for maintainability.
  • Rule-driven validation: enforce string IDs, no nullable fields, and clean resource paths.
  • Use Case: For example, design a User schema with a summary and full version using allOf to illustrate composition.

Quick Start

Define a User schema with both a summary and a full version using allOf to compose properties.

Dependency Matrix

Required Modules

None required

Components

Standard package

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: openapi-schemas
Download link: https://github.com/zerobias-org/module/archive/main.zip#openapi-schemas

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.