API Generating
huangjia2019/claude-code-engineering
Generate API endpoint documentation from Express route files.
Write clear, developer-facing API documentation. An agent skill from mohitagw15856/pm-claude-skills.
$ npx skills add mohitagw15856/pm-claude-skills --skill api-docs-writer -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install mohitagw15856/pm-claude-skills api-docs-writer --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/mohitagw15856/pm-claude-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/api-docs-writer .claude/skills/api-docs-writer && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "api-docs-writer" agent skill from https://github.com/mohitagw15856/pm-claude-skills/tree/main/skills/api-docs-writer into .claude/skills/api-docs-writer/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "api-docs-writer", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/mohitagw15856/pm-claude-skills/tree/main/skills/api-docs-writerType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add mohitagw15856/pm-claude-skills --skill api-docs-writer -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install mohitagw15856/pm-claude-skills api-docs-writer --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/mohitagw15856/pm-claude-skills.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/api-docs-writer .agents/skills/api-docs-writer && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "api-docs-writer" agent skill from https://github.com/mohitagw15856/pm-claude-skills/tree/main/skills/api-docs-writer into .agents/skills/api-docs-writer/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "api-docs-writer", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add mohitagw15856/pm-claude-skills --skill api-docs-writer -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install mohitagw15856/pm-claude-skills api-docs-writer --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/mohitagw15856/pm-claude-skills.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/api-docs-writer .cursor/skills/api-docs-writer && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "api-docs-writer" agent skill from https://github.com/mohitagw15856/pm-claude-skills/tree/main/skills/api-docs-writer into .cursor/skills/api-docs-writer/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "api-docs-writer", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/mohitagw15856/pm-claude-skills.git --path skills/api-docs-writer--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add mohitagw15856/pm-claude-skills --skill api-docs-writer -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install mohitagw15856/pm-claude-skills api-docs-writer --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/mohitagw15856/pm-claude-skills.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/api-docs-writer .gemini/skills/api-docs-writer && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "api-docs-writer" agent skill from https://github.com/mohitagw15856/pm-claude-skills/tree/main/skills/api-docs-writer into .gemini/skills/api-docs-writer/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "api-docs-writer", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install mohitagw15856/pm-claude-skills api-docs-writerInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add mohitagw15856/pm-claude-skills --skill api-docs-writer -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/mohitagw15856/pm-claude-skills.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/api-docs-writer .github/skills/api-docs-writer && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "api-docs-writer" agent skill from https://github.com/mohitagw15856/pm-claude-skills/tree/main/skills/api-docs-writer into .github/skills/api-docs-writer/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "api-docs-writer", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add mohitagw15856/pm-claude-skills --skill api-docs-writer -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install mohitagw15856/pm-claude-skills api-docs-writer --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/mohitagw15856/pm-claude-skills.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/api-docs-writer .opencode/skills/api-docs-writer && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "api-docs-writer" agent skill from https://github.com/mohitagw15856/pm-claude-skills/tree/main/skills/api-docs-writer into .opencode/skills/api-docs-writer/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "api-docs-writer", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
api-docs-writerWrite clear, developer-facing API documentation. An agent skill from mohitagw15856/pm-claude-skills.
API Docs Writer is an agent skill from mohitagw15856/pm-claude-skills. Write clear, developer-facing API documentation. Use when asked to document an API endpoint, write API reference docs, create a developer guide, or turn a raw spec/Postman collection into documentation. Produces endpoint documentation with descriptions, parameters, request/response examples, and error codes.
Its SKILL.md is about 1.9k tokens, which your agent loads only when the skill is triggered. The skill folder holds 5 other files, including reference files (for example `references/example-first-docs.md`, `references/worked-example.md` and `templates/endpoint-entry.md`).
It sits in Development, covering Technical documentation and REST APIs. It works with Postman. The repository describes itself as: 1255 professional Agent Skills for Claude, ChatGPT, Gemini, Cursor & Codex — PRDs, postmortems, leases, medical bills, layoffs, go-bags, new countries. Plain markdown, MIT, in… The licence is MIT.
Read from SKILL.md and the folder at commit 1cbf1f0. It shows what the files ask for, not the result of running them.
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Shell commands in SKILL.md call:
curlFrom the folder's file list and the shell code blocks in SKILL.md.
No URLs in SKILL.md. Its commands use curl, which can reach the network depending on how they are called.
From URLs in SKILL.md, links to its own repository left out.
Names these keys or tokens, usually read from environment variables:
INSERT_TOKENFrom names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
API Docs Writer loads about 1.9k tokens when it runs, and up to ~5.6k if it reads all its reference files. Until then it costs about 81 tokens; SKILL.md has 859 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
The full file from mohitagw15856/pm-claude-skills at commit 1cbf1f0, republished under its MIT licence (© mohitagw15856). 859 words, ~1,926 tokens.
.claude/skills/api-docs-writer/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.This skill transforms raw API specs, endpoint descriptions, or Postman collections into clean, developer-facing documentation following OpenAPI-adjacent conventions. Output is ready for a developer portal, README, or Notion/Confluence page.
Ask the user for these if not provided:
For each endpoint, produce the following:
[METHOD] /path/to/endpointSummary: [One line — what this endpoint does]
Description: [2–4 sentences. When to use this endpoint. What it returns. Any important behaviour to know (pagination, rate limits, async processing, etc.)]
Authentication: [Required / Optional — method]
Headers:
| Header | Required | Description |
|---|---|---|
Authorization | Yes | Bearer <token> |
Content-Type | Yes | application/json |
Path Parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | Yes | Unique identifier for the resource |
Query Parameters:
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
limit | integer | No | 20 | Max results per page (1–100) |
cursor | string | No | — | Pagination cursor from previous response |
Request Body:
{
"field_name": "value",
"another_field": 42
}| Field | Type | Required | Description |
|---|---|---|---|
field_name | string | Yes | [Plain description of what this field does] |
another_field | integer | No | [Description. Include valid range or enum values if applicable] |
Success Response: 200 OK
{
"id": "abc123",
"status": "active",
"created_at": "2025-04-01T10:00:00Z"
}| Field | Type | Description |
|---|---|---|
id | string | Unique identifier for the created/retrieved resource |
status | string | Current status. Enum: active, inactive, pending |
created_at | ISO 8601 string | Timestamp of creation in UTC |
| Status Code | Error Code | Description | How to Resolve |
|---|---|---|---|
400 | INVALID_REQUEST | Request body is malformed or missing required fields | Check request body against schema above |
401 | UNAUTHORIZED | Missing or invalid authentication token | Verify your API key or refresh your token |
404 | NOT_FOUND | The requested resource does not exist | Check the ID in the path parameter |
429 | RATE_LIMITED | Too many requests | Back off and retry after Retry-After header value |
500 | INTERNAL_ERROR | Unexpected server error | Retry with exponential backoff; contact support if persists |
Produce examples in at least 2 languages relevant to the audience (default: cURL + Python):
cURL:
curl -X POST https://api.example.com/v1/endpoint \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{"field_name": "value"}'Python:
import requests
response = requests.post(
"https://api.example.com/v1/endpoint",
headers={"Authorization": "Bearer YOUR_TOKEN"},
json={"field_name": "value"}
)
data = response.json()This skill ships with support files — use them when they are available:
references/example-first-docs.md — Example-First API Docs: the Rules That Make Docs Usable. Apply it while producing the output; it carries the calibration and judgment calls the method summary above compresses.templates/endpoint-entry.md — a fill-in version of the deliverable with the quality gates inline. Offer it when the user wants to work the document themselves rather than have it generated.Score any output of this skill before handing it over; 32+ is ship-quality.
| Dimension | 0 | 5 | 10 |
|---|---|---|---|
| Parameter completeness | Fields listed without types or required/optional flags | Tables complete, but descriptions say what a field is, not what it does; enums and ranges missing | Every field typed and constrained (enums, ranges, formats), described by behaviour and consequence |
| Error-path coverage | Happy path only — no error table | Standard 400/401/404/429/500 rows present but with no resolution guidance | Full standard set plus endpoint-specific codes, each with what the developer should do, including unsafe-retry cases |
| Example runnability | Pseudo-code, undefined variables, or "YOUR_ENDPOINT" placeholders | Examples exist but aren't copy-paste-runnable or use only one language | ≥2 languages, real base URL, obviously-fake placeholder credentials, runnable as pasted |
| Behavioural candour | Async behaviour, pagination, idempotency, and legacy quirks omitted | Quirks mentioned in prose but absent from examples and error rows | Gotchas documented with the exact requests/responses they produce, including awkward legacy behaviour |
© mohitagw15856, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
SKILL.md and 3 other files (references) in skills/api-docs-writer of mohitagw15856/pm-claude-skills.
Open the folder on GitHubat commit 1cbf1f0
API Docs Writer next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| API Docs Writer this skillmohitagw15856/pm-claude-skills | 1.4k | — | ~1.9k | Automated safety check: Pass | MIT | |
| API Generatinghuangjia2019/claude-code-engineering | 1.1k | — | ~426 | Automated safety check: Pass | None | |
| API Docslangchain-ai/skills-benchmarks | 118 | — | ~358 | Automated safety check: Pass | MIT | |
| Readme Generator Probeizhi23/README-Generator-Pro | 113 | — | ~472 | Automated safety check: Notes | None | |
| Finding TriageHacktronAI/skills | 115 | — | ~2.9k | Automated safety check: Notes | MIT | |
| OpenAPI Spec Generationwshobson/agents | 40k | 9 repos | ~511 | Automated safety check: Pass | MIT |
huangjia2019/claude-code-engineering
Generate API endpoint documentation from Express route files.
langchain-ai/skills-benchmarks
OpenAPI documentation and REST API design patterns. An agent skill from langchain-ai/skills-benchmarks.
beizhi23/README-Generator-Pro
Generate, modify, and render professional README.md files and project introduction HTML pages using the bundled README Generator Pro FastAPI application.
HacktronAI/skills
Interactively validate and triage Hacktron findings against the actual source code and (optionally) a live deployment, separate true positives from false positives, adjust severity, then either…
wshobson/agents
Create, validate and maintain OpenAPI 3.1 specs for REST APIs, whether designed first or generated from existing code, and use them for docs and client SDKs.
RedWoodOG/Hermes-Desktop
Review code changes by analyzing git diffs, leaving inline comments on PRs, and performing thorough pre-push review.
mohitagw15856/pm-claude-skills
Compare the total cost of car ownership across buy-new, buy-used, lease, and keep-your-current-car — depreciation, insurance, maintenance ramp, and fuel over a real horizon, not just the monthly…
mohitagw15856/pm-claude-skills
Build a customer health scorecard for a specific account. An agent skill from mohitagw15856/pm-claude-skills.
mohitagw15856/pm-claude-skills
Compute who gets what at each exit price from a cap table — liquidation preferences, conversion points, and where the founders' share collapses.
mohitagw15856/pm-claude-skills
Apply prioritisation frameworks (RICE, MoSCoW, Kano, ICE, Opportunity Scoring) to rank features and backlog items.
mohitagw15856/pm-claude-skills
Compute a financial-independence (FIRE) target and years-to-reach with every assumption labeled as an assumption — plus a sensitivity table instead of a single false-precision answer.
mohitagw15856/pm-claude-skills
Derive a freelance day/hourly rate backwards from target income, honest billable utilization, overhead, and the self-employment tax premium — the arithmetic that proves a rate is not salary÷2000.
Works with
Categories
Write clear, developer-facing API documentation. An agent skill from mohitagw15856/pm-claude-skills. API Docs Writer is an agent skill from mohitagw15856/pm-claude-skills. Write clear, developer-facing API documentation.
API Docs Writer fits situations like: asked to document an API endpoint; write API reference docs; create a developer guide; turn a raw spec/Postman collection into documentation.
Run `npx skills add mohitagw15856/pm-claude-skills --skill api-docs-writer -a claude-code`. Or copy the skill folder (skills/api-docs-writer in mohitagw15856/pm-claude-skills) into .claude/skills/api-docs-writer in your project. Claude Code loads it when a task matches its description.
Run `npx skills add mohitagw15856/pm-claude-skills --skill api-docs-writer -a codex`. Or copy the skill folder (skills/api-docs-writer in mohitagw15856/pm-claude-skills) into .agents/skills/api-docs-writer in your project. Codex loads it when a task matches its description.
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add mohitagw15856/pm-claude-skills --skill api-docs-writer -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/api-docs-writer, .gemini/skills/api-docs-writer, .github/skills/api-docs-writer and .opencode/skills/api-docs-writer in your project.
Going by SKILL.md and its folder, API Docs Writer needs the command-line tools its instructions call (curl) and credentials named INSERT_TOKEN. Our summary lists: Python 3; A credential in YOUR_TOKEN; A credential in INSERT_TOKEN.
SKILL.md contains no URLs. Its commands use curl, which can reach the network depending on how they are called. This is read from the text; nothing was executed.
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
API Docs Writer is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
About 1.9k tokens (SKILL.md is roughly 7.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 3.6k tokens, read only when the agent opens those files.
Skills that share tags, products or a category with API Docs Writer: API Generating (huangjia2019/claude-code-engineering, 1.1k stars), API Docs (langchain-ai/skills-benchmarks, 118 stars), Readme Generator Pro (beizhi23/README-Generator-Pro, 113 stars) and Finding Triage (HacktronAI/skills, 115 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
mohitagw15856 (a GitHub user) maintains it in mohitagw15856/pm-claude-skills, which has 1,433 GitHub stars. The repository holds 1,348 skills in this directory. The repository was last updated on October 8, 2026.
Source: mohitagw15856/pm-claude-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.