---
title: "OpenAPI Spec Generation - Air Market"
description: "Your API has a written description somewhere, and it drifts from what the code actually does. This helps you produce that description from the code, or write it first and build against it, and check…"
canonical: "https://airmarket.ai/app/openapi-spec-generation"
---

[Air Market](/) / [Developer Tools](/category/devtools) / OpenAPI Spec Generation

Skill by [Seth Hobson](/@wshobson)

# OpenAPI Spec Generation

Keep the API document and the API telling the same story

## What this does

Your API has a written description somewhere, and it drifts from what the code actually does. This helps you produce that description from the code, or write it first and build against it, and check that the two still agree. Reach for it when you need API documentation, client libraries generated from it, or proof that the contract is being kept.

### Top 3 things it does for you

- Generate an API spec from existing code
- Write the spec first, then build to it
- Check an API against the contract it promised

## Information

**OpenAPI Spec Generation at a glance**

|  |  |
| --- | --- |
| Kind | Skill |
| Publisher | [Seth Hobson](/@wshobson) |
| Category | [Developer Tools](/category/devtools) |
| Works with | Agent Skills - an open standard supported by 40+ agents |
| Size | 25 KB |
| Licence | MIT |
| Repository | [wshobson/agents](https://github.com/wshobson/agents/tree/be57c0b2e3c05c528ca6132b87410b385718775f/plugins/documentation-generation/skills/openapi-spec-generation) |
| GitHub stars | 39,077 (as of Nov 2026) |
| Installs | 17,056, counted by skills.sh (Nov 2026) |

## Security report

**Verified.** AIR scanned this exact version of OpenAPI Spec Generation and flagged nothing. AIR's verdict: **safe**.

**What OpenAPI Spec Generation's check was run against**

|  |  |
| --- | --- |
| Commit | be57c0b2e3c05c528ca6132b87410b385718775f |
| Content hash | e5920e711284a4c9b7b4f20920b7ee4edc4b0f24bd445d13abff2b81400a2c1d |
| Files read | [Browse the files at this exact commit](https://github.com/wshobson/agents/blob/be57c0b2e3c05c528ca6132b87410b385718775f/plugins/documentation-generation/skills/openapi-spec-generation/SKILL.md) |

A scan is named by the exact content it read, not by a version number. A different version is a different artifact, and nothing here applies to a version AIR has not scanned.

[Read the full security report for OpenAPI Spec Generation](/security/openapi-spec-generation)

## About OpenAPI Spec Generation

This generates and maintains OpenAPI 3.1 specifications, either from existing code or design-first, and covers validating them.

Use it when you are creating API documentation, generating SDKs from a spec, or making sure an API stays compliant with the contract it publishes.

## What's inside

- SKILL.md - instructions
- references/code-first-and-tooling.md - reference
- references/details.md - reference

## Questions

### Is OpenAPI Spec Generation safe to install?

AIR scanned this exact version of OpenAPI Spec Generation and flagged nothing. AIR's verdict: safe. The verdict is named by the content that was read, at commit be57c0b2e3c0, so it cannot drift onto a version nobody scanned. The full report is at https://airmarket.ai/security/openapi-spec-generation.

### How do I install OpenAPI Spec Generation?

Open https://airmarket.ai/app/openapi-spec-generation on Air Market and use the install action: Air Market hands Claude a prompt naming this exact skill, and Claude sets it up. Source, pinned to the exact commit this listing describes: https://github.com/wshobson/agents/tree/be57c0b2e3c05c528ca6132b87410b385718775f/plugins/documentation-generation/skills/openapi-spec-generation. Install from that link, not the branch.

## Related on Air Market

- [More Developer Tools listings](/category/devtools)
- [Everything by Seth Hobson](/@wshobson)

---

Canonical URL: <https://airmarket.ai/app/openapi-spec-generation>