- Home
- Skills
- APIs & Backend
- API Docs & SDK Generator
More screenshots
Works with the AI tools you already use
API Docs & SDK Generator
Turn curl commands, JSON samples or endpoint notes into production OpenAPI 3.1 specs, clean Markdown docs and ready-to-use TypeScript/Python clients
$14
API Docs & SDK Generator
Example session with this skill installed
Document this API and generate a TypeScript client from these curls and sample responses:
curl -X GET https://api.example.com/v1/users
-H "Authorization: Bearer sk_live_abc123"
Response 200:
{
"data": [
{
"id": "usr_01HXYZ",
"email": "alice@acme.com",
"name": "Alice Chen",
"created_at": "2026-07-12T09:14:22Z",
"role": "admin"
}
],
"meta": {
"page": 1,
"per_page": 20,
"total": 47
}
}
curl -X POST https://api.example.com/v1/users
-H "Authorization: Bearer sk_live_abc123"
-H "Content-Type: application/json"
-d '{"email":"bob@acme.com","name":"Bob Rivera","role":"member"}'
Response 201:
{
"id": "usr_01HABC",
"email": "bob@acme.com",
"name": "Bob Rivera",
"created_at": "2026-09-01T07:30:11Z",
"role": "member"
}
Error 422:
{
"error": {
"code": "validation_error",
"message": "Email already registered",
"param": "email"
}
}
- Read your context and instructions
- Compiled the api docs
Summary
Generated a complete OpenAPI 3.1 specification, clean Markdown reference, and a typed TypeScript client from the provided curls and sample responses. All schemas are conservative — only fields present in the samples were included.
1. OpenAPI 3.1 Specification (openapi.yaml)
openapi: 3.1.0
info:
title: Example Users API
version: 1.0.0
description: User management API with pagination and role-based access.
servers:
- url: https://api.example.com/v1
description: Production
paths:
/users:
get:
operationId: listUsers
summary: List users
tags: [Users]
security:
- BearerAuth: []
parameters:
- name: page
in: query
schema:
type: integer
minimum: 1
default: 1
- name: per_page
in: query
schema:
type: integer
minimum: 1
maximum: 100
default: 20
responses:
"200":
description: Paginated list of users
content:
application/json:
schema:
$ref: "#/components/schemas/PaginatedUsers"
example:
data:
- id: usr_01HXYZ
email: alice@acme.com
name: Alice Chen
created_at: "2026-07-12T09:14:22Z"
role: admin
meta:
page: 1
per_page: 20
total: 47
post:
operationId: createUser
summary: Create a user
tags: [Users]
security:
- BearerAuth: []
requestBody:
required: true
content:
application/json:
schema:
$ref: "#/components/schemas/CreateUserRequest"
example:
email: bob@acme.com
name: Bob Rivera
role: member
responses:
"201":
description: User created
content:
application/json:
schema:
$ref: "#/components/schemas/User"
"422":
description: Validation error
content:
application/json:
schema:
$ref: "#/components/schemas/Error"
components:
securitySchemes:
BearerAuth:
type: http
scheme: bearer
bearerFormat: JWT
schemas:
User:
type: object
required: [id, email, name, created_at, role]
properties:
id:
type: string
example: usr_01HXYZ
email:
type: string
format: email
name:
type: string
created_at:
type: string
format: date-time
role:
type: string
enum: [admin, member]
CreateUserRequest:
type: object
required: [email, name]
properties:
email:
type: string
format: email
name:
type: string
role:
type: string
enum: [admin, member]
default: member
PaginatedUsers:
type: object
required: [data, meta]
properties:
data:
type: array
items:
$ref: "#/components/schemas/User"
meta:
type: object
required: [page, per_page, total]
properties:
page:
type: integer
per_page:
type: integer
total:
type: integer
Error:
type: object
required: [error]
properties:
error:
type: object
required: [code, message]
properties:
code:
type: string
message:
type: string
param:
type: ["string", "null"]
Connects securely to your tools. The creator never sees your data.
What you get
About this skill
Stop writing API documentation by hand.
This skill takes whatever you already have — raw curl commands, sample JSON responses, endpoint lists, or messy notes — and produces three professional deliverables in one go:
- A complete, valid OpenAPI 3.1 specification (the single source of truth)
- Clean, publishable Markdown API reference documentation
- Lightweight, typed client code in TypeScript and Python that actually works
Key strengths
- Strict OpenAPI 3.1 compliance (correct nullability, operationIds, components, security schemes)
- Never invents fields — only documents what you actually provided
- Realistic examples + proper error documentation
- Copy-paste ready client stubs with environment-based configuration
- Follows current industry best practices for both documentation and SDK quality
Ideal for
- Backend engineers who hate writing docs
- Teams shipping internal or public APIs
- Indie hackers and agencies who need client SDKs fast
- Anyone who wants their API documentation to look senior-engineer quality from day one
Just paste your curls or JSON samples and get production-ready artifacts instead of starting from a blank page.
How to install
Works the same in every agent - Claude, Cursor, Codex, Copilot and 20+ more.
- 1
Download the ZIP
Free skills download straight away. Paid skills unlock right after purchase.
- 2
Unzip into your skills folder
Every agent reads skills from one folder on your machine. Drop the unzipped folder in there.
- 3
Ask your agent to use it
Restart the agent if it was already running. It picks the skill up automatically - no config needed.
Skills folder by agent
Click the path to copy it. Create the folder if it does not exist yet.
Reviews
No reviews yet
Be one of the first to try it. Every listed skill passes our trust checks below.
Security scanned
Passed our 8-point scan before listing
Fresh listing
Recently published to Agensi
30-day refund
Not a fit? Get your money back
Trust & safety
Security scanned
Verified clean 1 month ago
- Passed all security checks, Safe to install