openapi-specification-v3.2

Installation
SKILL.md

OpenAPI Specification 3.2

Agent-oriented reference for the OpenAPI Specification 3.2.0. Use when editing, generating, or validating OpenAPI descriptions (OAD).

When to Use

  • Authoring or updating OpenAPI 3.2 YAML/JSON documents
  • Resolving $ref, $self, and relative URIs in multi-document OADs
  • Describing paths, operations, parameters (query/path/header/cookie/querystring), request body, and responses
  • Using Schema Objects (JSON Schema Draft 2020-12 dialect), components, and references
  • Configuring security schemes (apiKey, http, mutualTLS, oauth2, openIdConnect) and requirements
  • Working with media types, encoding (form, multipart), and examples (dataValue/serializedValue/externalValue)

Core References

Topic Description Reference
OpenAPI Object Root object, openapi, $self, info, servers, paths, webhooks, components, security, tags core-openapi-object
Format & Structure JSON/YAML, case sensitivity, rich text, OAD structure, parsing, base URI core-format-and-structure
Related skills
Installs
525
Repository
hairyf/skills
GitHub Stars
19
First Seen
Jan 30, 2026