openapi-specification-v3.2

Author and validate OpenAPI Specification 3.2 documents with JSON Schema 2020-12.

Updated Mar 5, 2026
One-click install
npx skills add https://github.com/pohlai88/AFENDA --skill openapi-specification-v3-2
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openapi-specification-v3.2
Source: https://github.com/pohlai88/AFENDA/tree/main/.agents/skills/openapi-specification-v3.2
Command: npx skills add https://github.com/pohlai88/AFENDA --skill openapi-specification-v3-2

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps you understand, author, and validate OpenAPI descriptions (OADs) for APIs, ensuring consistency and correctness in your API documentation.

Core Features & Use Cases

  • Authoring & Validation: Create and verify OpenAPI 3.2 documents.
  • Reference Resolution: Understand how to resolve $ref, $self, and relative URIs in multi-document OADs.
  • Schema & Component Management: Work with JSON Schema 2020-12, components, and reusable elements.
  • Use Case: You need to document a new API endpoint. Use this Skill to ensure your OpenAPI 3.2 YAML file correctly defines the path, parameters, request body, and responses according to the specification.

Quick Start

Use the openapi-specification-v3.2 skill to explain how to define parameters in an OpenAPI 3.2 document.

Frequently Asked Questions about openapi-specification-v3.2

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

FAQPage Schema
How do I define parameters in an OpenAPI 3.2 document?

Define parameters in an OpenAPI 3.2 document by specifying them under paths and operations, detailing their names, locations, descriptions, and required statuses. This structure ensures correct API request validation and documentation.

What is the best way to resolve $ref and relative URIs in multi-document OpenAPI descriptions?

Resolve $ref and relative URIs in multi-document OpenAPI descriptions by understanding reference resolution mechanisms. This process standardizes how external and internal schema references are fetched and validated within your API specification.

Can I use JSON Schema 2020-12 with OpenAPI 3.2 for component management?

Yes, OpenAPI 3.2 supports JSON Schema 2020-12 for component management. You can define reusable elements and schemas within the components object, ensuring consistency and correctness across your API documentation.

How do I validate request and response structures in an OpenAPI YAML file?

Validate request and response structures in an OpenAPI YAML file by defining the requestBody and responses objects under each operation. This ensures your API documentation correctly matches the expected API payloads and status codes.

Does OpenAPI 3.2 support defining security definitions for API endpoints?

Yes, OpenAPI 3.2 supports defining security definitions for API endpoints. You can specify security schemes and requirements within your specification to document authentication and authorization protocols for your API operations.