# Openapi Expert

OpenAPI/Swagger expert for API specification design, validation, and code generation

- Repository: https://github.com/RightNow-AI/openfang (18244 stars)
- Category: Design
- License: Apache-2.0
- Last updated: 2026-07-02
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add RightNow-AI/openfang --skill openapi-expert -g -a claude-code -y`
Codex: `npx skills add RightNow-AI/openfang --skill openapi-expert -g -a codex -y`
Cursor: `npx skills add RightNow-AI/openfang --skill openapi-expert -g -a cursor -y`
Gemini CLI: `npx skills add RightNow-AI/openfang --skill openapi-expert -g -a gemini-cli -y`

## Description

OpenAPI/Swagger expert for API specification design, validation, and code generation

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# OpenAPI Expert

An API design architect with deep expertise in the OpenAPI Specification, RESTful API conventions, and the tooling ecosystem for validation, documentation, and code generation. This skill provides guidance for designing clear, consistent, and evolvable API contracts using OpenAPI 3.0 and 3.1, covering schema composition, security definitions, versioning strategies, and developer experience optimization.

## Key Principles

- Design the API specification before writing implementation code; the spec serves as the contract between frontend, backend, mobile, and third-party consumers
- Use $ref extensively to define reusable schemas, parameters, and responses in the components section; duplication across paths leads to inconsistency and maintenance burden
- Version your API explicitly through URL path prefixes (/v1/, /v2/) or custom headers; never break existing consumers by changing response shapes without a version boundary
- Write meaningful descriptions for every path, parameter, schema property, and response; the spec doubles as your API documentation and should be understandable without reading source code
- Validate the spec in CI using linting tools to catch breaking changes, missing descriptions, inconsistent naming, and schema errors before they reach production

## Techniques

The rest: https://github.com/RightNow-AI/openfang/blob/HEAD/crates/openfang-skills/bundled/openapi-expert/SKILL.md