Agent skill

API Generating

by huangjia2019 in huangjia2019/claude-code-engineering

Generate API endpoint documentation from Express route files.

No licenceAuto-check passedDevelopment

Install API Generating

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

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

GitHub CLI
$ gh skill install huangjia2019/claude-code-engineering api-generating --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/06-agent-skill-combo/.claude/skills/api-generating .claude/skills/api-generating && 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-generating
GitHub stars
1.1k
Used in
1 other repo
Token cost
~426 tokens
SKILL.md length
171 words
Files
3 (incl. scripts)
Skills in repo
10
Repo updated
First seen
Licence
None found

At a glance

Generate API endpoint documentation from Express route files.

  • Works in 3 steps: Route Discovery(路由发现) → Route Analysis(路由分析) → Documentation Generation(文档生成)
  • The user asks to generate
  • SKILL.md covers 工作流程 — MANDATORY, Reference Files and Quality Checklist
  • Runs Python scripts from its folder; calls python3

What it does

API Generating is an agent skill from huangjia2019/claude-code-engineering. Generate API endpoint documentation from Express route files. Use when the user asks to generate, update, or review API docs for Express.js routes.

Its SKILL.md is about 430 tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including scripts (for example `scripts/detect-routes.py` and `templates/api-doc.md`).

It sits in Development, covering Technical documentation and REST APIs. It works with Express. 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 asks to generate
  • Review API docs for Express.js routes

Example prompts

  • “/api-generating”

Requirements

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

Workflow steps

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

  1. Route Discovery(路由发现)
  2. Route Analysis(路由分析)
  3. Documentation Generation(文档生成)

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
    • Bash(python *)

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python3

    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 Generating loads about 426 tokens when it runs. Until then it costs about 41 tokens; SKILL.md has 171 words of instructions outside code blocks.

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

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 171 words (~426 tokens).

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

— opening of SKILL.md by huangjia2019
name
api-generating
allowed-tools
Read, Grep, Glob, Write, Bash(python *)

Read the full SKILL.md on GitHub

Files

SKILL.md and 2 other files (scripts) in 04-Skills/projects/06-agent-skill-combo/.claude/skills/api-generating of huangjia2019/claude-code-engineering.

  • SKILL.md
  • scripts/detect-routes.py
  • templates/api-doc.md

Open the folder on GitHubat commit 89fea03

Used in 1 other repository

We found 1 copy 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 Generating 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 Generating compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
API Generating this skillhuangjia2019/claude-code-engineering1.1k1 repos~426Automated safety check: PassNone
API Docslangchain-ai/skills-benchmarks118—~358Automated safety check: PassMIT
API Docs Writermajiayu000/claude-skill-registry6661 repos~1.3kAutomated safety check: PassMIT
Readme Generator Probeizhi23/README-Generator-Pro113—~472Automated safety check: NotesNone
Finding TriageHacktronAI/skills115—~2.9kAutomated safety check: NotesMIT
OpenAPI Spec Generationwshobson/agents40k10 repos~511Automated safety check: PassMIT

Similar skills

  • API Docs

    langchain-ai/skills-benchmarks

    Official

    OpenAPI documentation and REST API design patterns. An agent skill from langchain-ai/skills-benchmarks.

    118 GitHub stars~358 tokensUpdated 17 days ago
    DevelopmentAuto-check passed
  • API Docs Writer

    majiayu000/claude-skill-registry

    Write clear, developer-facing API documentation. An agent skill from majiayu000/claude-skill-registry.

    666 GitHub starsUsed in 1 repo~1.3k tokens
    DevelopmentAuto-check passed
  • Readme Generator Pro

    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.

    113 GitHub stars~472 tokensUpdated 3 mo ago
    Backend & APIsAuto-check: notes
  • Finding Triage

    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…

    115 GitHub stars~2.9k tokensUpdated 4 mo ago
    Backend & APIsAuto-check: notes
  • 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
  • GitHub Code Review

    RedWoodOG/Hermes-Desktop

    Review code changes by analyzing git diffs, leaving inline comments on PRs, and performing thorough pre-push review.

    177 GitHub starsUsed in 5 repos~3.4k tokens
    DevelopmentAuto-check: notes

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 Documenting

    huangjia2019/claude-code-engineering

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

    1.1k GitHub starsUsed in 1 repo~396 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
  • 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

Questions about API Generating

What does API Generating do?

Generate API endpoint documentation from Express route files. API Generating is an agent skill from huangjia2019/claude-code-engineering. Generate API endpoint documentation from Express route files.

When should I use API Generating?

API Generating fits situations like: the user asks to generate; review API docs for Express.js routes.

How do I install API Generating in Claude Code?

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

How do I install API Generating in Codex?

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

Can I use API Generating 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-generating -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-generating, .gemini/skills/api-generating, .github/skills/api-generating and .opencode/skills/api-generating in your project.

What does API Generating need to run?

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

Does API Generating 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 Generating 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 Generating use?

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

How many tokens does API Generating use?

About 426 tokens (SKILL.md is roughly 1.7k 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 Generating?

Skills that share tags, products or a category with API Generating: API Docs (langchain-ai/skills-benchmarks, 118 stars), API Docs Writer (majiayu000/claude-skill-registry, 666 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.

Who maintains API Generating?

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.