API Docs Generator

Generate comprehensive API documentation from OpenAPI specs, code docstrings, JSDoc/TSDoc comments, and Markdown annotations. Use when creating or updating API documentation in /docs/API.md from various source formats including Swagger, Python docstrings, TypeScript interfaces, or inline comments.

9 stars 4 forksWriting & Content

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add tomique34/claude-skill-creator --skill api-docs-generator
Manual install
git clone --depth 1 https://github.com/tomique34/claude-skill-creator.git /tmp/claude-skill-creator
mkdir -p ~/.claude/skills
cp -r /tmp/claude-skill-creator/api-docs-generator ~/.claude/skills/api-docs-generator

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# API Documentation Generator

## Overview

Automatically generate clean, comprehensive API documentation from multiple source formats and save to `/docs/API.md`. Supports OpenAPI/Swagger specifications, Python/JavaScript/TypeScript docstrings, JSDoc/TSDoc comments, and inline Markdown documentation.

## Quick Start

Provide API source code or specifications and specify the output location:

```
"Generate API docs from openapi.yaml and save to /docs/API.md"
"Create API documentation from these Python docstrings"
"Document this REST API and save to docs folder"
```

The skill will:
1. Parse the source format (OpenAPI, docstrings, JSDoc, etc.)
2. Extract endpoints, parameters, responses, and examples
3. Generate well-formatted Markdown documentation
4. Save to `/docs/API.md` or specified location

## Detailed Instructions

### Step 1: Identify Source Format

Recognize and parse different documentation sources:

#### OpenAPI/Swagger Specifications

**YAML Format:**
```yaml
openapi: 3.0.0
info:
  title: User API
  version: 1.0.0
paths:
  /users/{id}:
    get:
      summary: Get user by ID
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: integer
      responses:
        '200':
          description: Successful response
```

**JSON Format:**
Read the full skill on GitHub

Details

Skill name
api-docs-generator
Path
api-docs-generator/SKILL.md
License
MIT
Repo updated
1 December 2025

FAQ

What does the API Docs Generator skill do?

Generate comprehensive API documentation from OpenAPI specs, code docstrings, JSDoc/TSDoc comments, and Markdown annotations. Use when creating or updating API documentation in /docs/API.md from various source formats including Swagger, Python docstrings, TypeScript interfaces, or inline comments.

How do I install the API Docs Generator skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add tomique34/claude-skill-creator --skill api-docs-generator. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is API Docs Generator popular?

It lives in tomique34/claude-skill-creator, which has 9 GitHub stars and 4 forks.

Related skills

Agent Skill Creator

9

tomique34/claude-skill-creator

Create and structure Claude Agent Skills from user requirements. Use when the user wants to create a new skill, build a skill template, or structure skill directories with SKILL.md files, templates, and examples.

Skill & Plugin Authoring

Changelog Newsletter

9

tomique34/claude-skill-creator

Transform technical changelog entries into user-friendly newsletter content for email, blog posts, and release notes. Use when converting CHANGELOG.md files, git commit logs, or release notes into customer-facing communications.

Git & Code Review

Meeting Notes to Action Items

9

tomique34/claude-skill-creator

Convert meeting notes, demo sessions, and discussions into actionable tasks with clear owners, priorities, and deadlines. Use when processing any meeting notes, demo feedback, product reviews, or discussions that need to become TODO lists, JIRA tickets, or Trello cards.

Productivity & Notes

Strapi Docs MCP

9

strapi/skills

Query the official Strapi documentation through the strapi-docs MCP server (powered by Kapa). Use for any Strapi question — API syntax, configuration, features, plugins, upgrades, CLI. If the server is missing, instruct the user how to install it.

Writing & Content

Walter Writes Writer

9

walterwritesai/no-slop-ai-humanizer-rewriter

Write content that avoids AI tells from the start. Use when generating any prose — articles, emails, social posts, reports — where the output should sound human, not machine-made.

Writing & Content

Strapi Version Upgrade

9

strapi/skills

Upgrade a Strapi application to a new version. ALWAYS reviews the relevant breaking changes first (via the strapi-docs MCP server, or by fetching the docs directly if the MCP is unavailable), then performs the upgrade using the official @strapi/upgrade tool. Use whenever the user wants to upgrade, update, or bump their Strapi version.

Writing & Content

Browse the most popular Claude skills, all writing & content skills, or write your own with the skills generator.