How do I install the API Docs Gen skill?

Run npx skillmds@latest add kbarbel640-del/api-docs-gen in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is API Docs Gen safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: makes network calls. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with API Docs Gen?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is API Docs Gen free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published API Docs Gen?

kbarbel640-del (@kbarbel640-del) published this skill. Their other Agent Skills are listed on their SkillMD profile.

API Docs Gen by kbarbel640-del — Agent Skill

Name: API Docs Gen
Rating: 4.2 (5 reviews)
Author: kbarbel640-del

File contents

API Docs Generator

Your API has 50 endpoints and zero documentation. This tool reads your route files and generates proper docs, either markdown for humans or OpenAPI specs for tools.

One command. Zero config. Just works.

Quick Start

npx ai-api-docs ./src/routes/

What It Does

Scans your route files and extracts endpoint information
Generates clean markdown documentation
Outputs OpenAPI 3.0 specs for Swagger and other tools
Documents request/response shapes automatically

Usage Examples

# Generate markdown docs
npx ai-api-docs ./src/routes/
# → API_DOCS.md

# Generate OpenAPI spec
npx ai-api-docs ./src/routes/ --format openapi -o spec.yaml

# Custom output path
npx ai-api-docs ./src/api/ -o docs/api.md

# Scan multiple directories
npx ai-api-docs ./routes ./handlers

Best Practices

Keep routes organized - cleaner code means better docs
Use TypeScript - type info improves generated descriptions
Review and edit - AI gets structure right, you add context
Regenerate on changes - make it part of your CI

When to Use This

You inherited a codebase with no API docs
Shipping an MVP and docs are the last thing on your list
Need to generate Swagger UI quickly
Onboarding new developers to your API

Part of the LXGIC Dev Toolkit

This is one of 110+ free developer tools built by LXGIC Studios. No paywalls, no sign-ups, no API keys on free tiers. Just tools that work.

Find more:

GitHub: https://github.com/LXGIC-Studios
Twitter: https://x.com/lxgicstudios
Substack: https://lxgicstudios.substack.com
Website: https://lxgicstudios.com

Requirements

No install needed. Just run with npx. Node.js 18+ recommended. Needs OPENAI_API_KEY environment variable.

npx ai-api-docs --help

How It Works

Parses your route files to extract HTTP methods, paths, and handler code. Then uses GPT-4o-mini to infer request/response shapes, add descriptions, and format everything according to markdown or OpenAPI standards.

License

MIT. Free forever. Use it however you want.

Built by LXGIC Studios

GitHub: github.com/lxgicstudios/ai-api-docs
Twitter: @lxgicstudios

---name: api-docs-gendescription: Generate API documentation from route files. Use when you need markdown or OpenAPI specs fast.---# API Docs GeneratorYour API has 50 endpoints and zero documentation. This tool reads your route files and generates proper docs, either markdown for humans or OpenAPI specs for tools.**One command. Zero config. Just works.**## Quick Start```bashnpx ai-api-docs ./src/routes/```## What It Does- Scans your route files and extracts endpoint information- Generates clean markdown documentation- Outputs OpenAPI 3.0 specs for Swagger and other tools- Documents request/response shapes automatically## Usage Examples```bash# Generate markdown docsnpx ai-api-docs ./src/routes/# → API_DOCS.md# Generate OpenAPI specnpx ai-api-docs ./src/routes/ --format openapi -o spec.yaml# Custom output pathnpx ai-api-docs ./src/api/ -o docs/api.md# Scan multiple directoriesnpx ai-api-docs ./routes ./handlers```## Best Practices- **Keep routes organized** - cleaner code means better docs- **Use TypeScript** - type info improves generated descriptions- **Review and edit** - AI gets structure right, you add context- **Regenerate on changes** - make it part of your CI## When to Use This- You inherited a codebase with no API docs- Shipping an MVP and docs are the last thing on your list- Need to generate Swagger UI quickly- Onboarding new developers to your API## Part of the LXGIC Dev ToolkitThis is one of 110+ free developer tools built by LXGIC Studios. No paywalls, no sign-ups, no API keys on free tiers. Just tools that work.**Find more:**- GitHub: https://github.com/LXGIC-Studios- Twitter: https://x.com/lxgicstudios- Substack: https://lxgicstudios.substack.com- Website: https://lxgicstudios.com## RequirementsNo install needed. Just run with npx. Node.js 18+ recommended. Needs OPENAI_API_KEY environment variable.```bashnpx ai-api-docs --help```## How It WorksParses your route files to extract HTTP methods, paths, and handler code. Then uses GPT-4o-mini to infer request/response shapes, add descriptions, and format everything according to markdown or OpenAPI standards.## LicenseMIT. Free forever. Use it however you want.---**Built by LXGIC Studios**- GitHub: [github.com/lxgicstudios/ai-api-docs](https://github.com/lxgicstudios/ai-api-docs)- Twitter: [@lxgicstudios](https://x.com/lxgicstudios)

Frequently asked questions

API Docs Gen