# API Generating

Generate API endpoint documentation from Express route files.

- Repository: https://github.com/huangjia2019/claude-code-engineering (1147 stars)
- Category: Writing
- License: see repository
- Last updated: 2026-07-23
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add huangjia2019/claude-code-engineering --skill api-generating -g -a claude-code -y`
Codex: `npx skills add huangjia2019/claude-code-engineering --skill api-generating -g -a codex -y`
Cursor: `npx skills add huangjia2019/claude-code-engineering --skill api-generating -g -a cursor -y`
Gemini CLI: `npx skills add huangjia2019/claude-code-engineering --skill api-generating -g -a gemini-cli -y`

## Description

Generate API endpoint documentation from Express route files. Use when the user asks to generate, update, or review API docs for Express.js routes.

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

# API 文档生成 Skill

## 工作流程, MANDATORY

**IMPORTANT**: You MUST follow these steps in order. DO NOT skip or substitute any step.

### Step 1: Route Discovery（路由发现）

**You MUST use the Python script for route detection:**

```bash
python3 skills/scripts/detect-routes.py src/
```

DO NOT manually search for routes using Grep, the script handles edge cases
(dynamic routes, middleware-mounted sub-routers, re-exported routes) that Grep
patterns will miss.

### Step 2: Route Analysis（路由分析）

For each route discovered by the script:

1. Read the route handler source file
2. Identify: HTTP method, path, parameters, request body schema, response schema
3. Check for authentication middleware (e.g., `requireAuth`, `isAdmin`)
4. Check for validation middleware (e.g., `validate(schema)`)

### Step 3: Documentation Generation（文档生成）

Use the template at `templates/api-doc.md` to generate documentation.

**Output rules:**
- One markdown file per route group (e.g., `docs/api/users.md`)
- Include request/response examples
- Mark authenticated endpoints with 🔒

## Reference Files

- Route detection script: `scripts/detect-routes.py`
- Documentation template: `templates/api-doc.md`
- Express routing patterns: see PATTERNS.md (same directory)

## Quality Checklist

Before finishing, verify:
- [ ] All routes from script output are documented
- [ ] Request/response schemas match actual code
- [ ] Auth requirements are marked
- [ ] Examples are valid JSON