Agent skill

API Documenting

by huangjia2019 in huangjia2019/claude-code-engineering

Generate API documentation from code. An agent skill from huangjia2019/claude-code-engineering.

No licenceAuto-check passedBackend & APIs

Install API Documenting

skills CLI
$ npx skills add huangjia2019/claude-code-engineering --skill api-documenting -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install huangjia2019/claude-code-engineering api-documenting --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/huangjia2019/claude-code-engineering.git skills-src && mkdir -p .claude/skills && cp -r skills-src/04-Skills/projects/02-progressive-skill .claude/skills/api-documenting && rm -rf skills-src

Use ~/.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/

Facts

Skill name
api-documenting
GitHub stars
1.1k
Used in
1 other repo
Token cost
~396 tokens
SKILL.md length
138 words
Files
11 (incl. scripts)
Skills in repo
10
Repo updated
First seen
Licence
None found

At a glance

Generate API documentation from code. An agent skill from huangjia2019/claude-code-engineering.

  • Works in 4 steps: Identify API Endpoints → Extract Information → Generate Documentation → …
  • The user wants to document APIs
  • SKILL.md covers Quick Reference, Documentation Standards, Process and Output Formats, plus 2 more sections
  • Runs Python and Shell scripts from its folder; calls python

What it does

API Documenting is an agent skill from huangjia2019/claude-code-engineering. Generate API documentation from code. Use when the user wants to document APIs, create API reference, generate endpoint documentation, or needs help with OpenAPI/Swagger specs.

Its SKILL.md is about 400 tokens, which your agent loads only when the skill is triggered. The skill folder holds 13 other files, including scripts (for example `EXAMPLES.md`, `PATTERNS.md` and `README.md`).

It sits in Backend & APIs, covering OpenAPI specifications and Technical documentation. It works with OpenAPI. The repository describes itself as: This repository demonstrates how to use Claude Code to do real engineering work, not just writing code. 本项目是极客时间专栏 《Claude Code 工程化实战》 的官方配套示例仓库,目标就是: 👉 把 Claude Code…

When your agent uses it

  • The user wants to document APIs
  • Create API reference
  • Generate endpoint documentation
  • Needs help with OpenAPI/Swagger specs

Example prompts

  • “/api-documenting”

Requirements

  • Python 3
  • A Bash shell
  • Pre-approved tools (allowed-tools): Read, Grep, Glob, Write

Workflow steps

4 steps, taken from the step headings in SKILL.md.

  1. Identify API Endpoints
  2. Extract Information
  3. Generate Documentation
  4. Create Overview

What it can do on your machine

Read from SKILL.md and the folder at commit 89fea03. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Read
    • Grep
    • Glob
    • Write

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 2 files in scripts/ (Python and Shell), which the agent can run.

    Shell commands in SKILL.md call:

    • python

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

API Documenting loads about 396 tokens when it runs. Until then it costs about 48 tokens; SKILL.md has 138 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~48
When it runs · the whole SKILL.md, loaded when a task matches
~396

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.

Safety

Auto-check passed

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); the scripts in this folder are not scanned.

SKILL.md

Without a licence we can't republish the file, so here is its outline and opening line. It has 138 words (~396 tokens).

“Generate comprehensive API documentation from source code.”

— opening of SKILL.md by huangjia2019
name
api-documenting
allowed-tools
Read, Grep, Glob, Write

Read the full SKILL.md on GitHub

Files

SKILL.md and 10 other files (scripts) in 04-Skills/projects/02-progressive-skill of huangjia2019/claude-code-engineering.

  • SKILL.md
  • .claude/skills
  • EXAMPLES.md
  • PATTERNS.md
  • README.md
  • STANDARDS.md
  • scripts/detect_routes.py
  • scripts/validate_openapi.sh
  • templates/endpoint.md
  • templates/index.md
  • templates/openapi.yaml

Open the folder on GitHubat commit 89fea03

Used in 1 other repository

We found 3 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in huangjia2019/claude-code-engineering, which our catalogue first saw on October 7, 2026.

Compare with similar skills

API Documenting 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.

API Documenting compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
API Documenting this skillhuangjia2019/claude-code-engineering1.1k1 repos~396Automated safety check: PassNone
CLI Creatorhuangruiteng/CS-Notes4k2 repos~2.7kAutomated safety check: PassApache-2.0
Api2clialexknowshtml/api2cli455—~2.9kAutomated safety check: PassMIT
Distilled SDKalchemy-run/distilled431—~6kAutomated safety check: PassApache-2.0
API Documenteralirezarezvani/claude-code-tresor777—~1.5kAutomated safety check: PassMIT
OpenAPI Spec Generationwshobson/agents40k10 repos~511Automated safety check: PassMIT

Similar skills

  • CLI Creator

    huangruiteng/CS-Notes

    Build a composable CLI for Codex from API docs, an OpenAPI spec, existing curl examples, an SDK, a web app, an admin tool, or a local script.

    4k GitHub starsUsed in 2 repos~2.7k tokens
    Backend & APIsAuto-check passed
  • Api2cli

    alexknowshtml/api2cli

    Generate a working CLI from any API, then wrap it in a Claude Code skill.

    455 GitHub stars~2.9k tokensUpdated 7 mo ago
    Backend & APIsAuto-check passed
  • Distilled SDK

    alchemy-run/distilled

    Build or update a distilled SDK for an API provider — sourcing its OpenAPI/Smithy/GraphQL/discovery description, adding the spec mirror that feeds it, generating packages/<provider, listing it on…

    431 GitHub stars~6k tokensUpdated today
    Backend & APIsAuto-check passed
  • API Documenter

    alirezarezvani/claude-code-tresor

    Auto-generate API documentation from code and comments. An agent skill from alirezarezvani/claude-code-tresor.

    777 GitHub stars~1.5k tokensUpdated 3 mo ago
    Backend & APIsAuto-check passed
  • 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.

    40k GitHub starsUsed in 10 repos~511 tokens
    Backend & APIsAuto-check passed
  • Sap API Style

    secondsky/sap-skills

    This skill provides comprehensive guidance for documenting SAP APIs following the SAP API Style Guide standards.

    462 GitHub stars~4.4k tokensUpdated 3 days ago
    Backend & APIsAuto-check passed

More from huangjia2019/claude-code-engineering

All 10 skills in this repo
  • Financial Analyzing

    huangjia2019/claude-code-engineering

    Analyze financial data, calculate financial ratios, and generate analysis reports.

    1.1k GitHub starsUsed in 1 repo~474 tokens
    Auto-check passed
  • API Generating

    huangjia2019/claude-code-engineering

    Generate API endpoint code and documentation from specifications.

    1.1k GitHub starsUsed in 1 repo~379 tokens
    Auto-check passed
  • API Generating

    huangjia2019/claude-code-engineering

    Generate API endpoint documentation from Express route files.

    1.1k GitHub starsUsed in 1 repo~426 tokens
    Auto-check passed
  • Code Health Check

    huangjia2019/claude-code-engineering

    Perform a comprehensive code health check on a directory. An agent skill from huangjia2019/claude-code-engineering.

    1.1k GitHub stars~489 tokensUpdated 2 mo ago
    Auto-check passed
  • API Conventions

    huangjia2019/claude-code-engineering

    API design patterns and conventions for this project. An agent skill from huangjia2019/claude-code-engineering.

    1.1k GitHub starsUsed in 1 repo~398 tokens
    Auto-check passed
  • Code Reviewing

    huangjia2019/claude-code-engineering

    Review code for quality, security, and best practices. An agent skill from huangjia2019/claude-code-engineering.

    1.1k GitHub stars~499 tokensUpdated 2 mo ago
    Auto-check passed

Works with

Categories

Questions about API Documenting

What does API Documenting do?

Generate API documentation from code. An agent skill from huangjia2019/claude-code-engineering. API Documenting is an agent skill from huangjia2019/claude-code-engineering. Generate API documentation from code.

When should I use API Documenting?

API Documenting fits situations like: the user wants to document APIs; create API reference; generate endpoint documentation; needs help with OpenAPI/Swagger specs.

How do I install API Documenting in Claude Code?

Run `npx skills add huangjia2019/claude-code-engineering --skill api-documenting -a claude-code`. Or copy the skill folder (04-Skills/projects/02-progressive-skill in huangjia2019/claude-code-engineering) into .claude/skills/api-documenting in your project. Claude Code loads it when a task matches its description.

How do I install API Documenting in Codex?

Run `npx skills add huangjia2019/claude-code-engineering --skill api-documenting -a codex`. Or copy the skill folder (04-Skills/projects/02-progressive-skill in huangjia2019/claude-code-engineering) into .agents/skills/api-documenting in your project. Codex loads it when a task matches its description.

Can I use API Documenting in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add huangjia2019/claude-code-engineering --skill api-documenting -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-documenting, .gemini/skills/api-documenting, .github/skills/api-documenting and .opencode/skills/api-documenting in your project.

What does API Documenting need to run?

Going by SKILL.md and its folder, API Documenting needs Python and a shell for the scripts in its folder and the command-line tools its instructions call (python). Our summary lists: Python 3; A Bash shell. Its frontmatter pre-approves these tools: Read, Grep, Glob, Write.

Does API Documenting access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is API Documenting safe to install?

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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does API Documenting use?

No licence was found for API Documenting or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does API Documenting use?

About 396 tokens (SKILL.md is roughly 1.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to API Documenting?

Skills that share tags, products or a category with API Documenting: CLI Creator (huangruiteng/CS-Notes, 4k stars), Api2cli (alexknowshtml/api2cli, 455 stars), Distilled SDK (alchemy-run/distilled, 431 stars) and API Documenter (alirezarezvani/claude-code-tresor, 777 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains API Documenting?

huangjia2019 (a GitHub user) maintains it in huangjia2019/claude-code-engineering, which has 1,133 GitHub stars. The repository holds 10 skills in this directory. The repository was last updated on July 23, 2026.

Source: huangjia2019/claude-code-engineering on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.