跳到正文
cccskills
免费在 GitHub 公开

api-generating

Generate API endpoint code and documentation from specifications. Use when the user wants to create new API endpoints, generate route handlers, scaffold REST APIs, or produce OpenAPI/Swagger specs from code.

中文简介正在准备中。当前显示原文说明。

查看安装方法

包含的文件(19)

  • SKILL.md1.5 KB
  • .claude/skills/api-generating/EXAMPLES.md2.7 KB
  • .claude/skills/api-generating/PATTERNS.md1.6 KB
  • .claude/skills/api-generating/scripts/detect_routes.py3.4 KB
  • .claude/skills/api-generating/scripts/validate_openapi.sh2.2 KB
  • .claude/skills/api-generating/SKILL.md1.5 KB
  • .claude/skills/api-generating/STANDARDS.md1.7 KB
  • .claude/skills/api-generating/templates/endpoint.md873 B
  • .claude/skills/api-generating/templates/index.md881 B
  • .claude/skills/api-generating/templates/openapi.yaml1.6 KB
  • EXAMPLES.md2.7 KB
  • PATTERNS.md1.6 KB
  • README.md2.2 KB
  • scripts/detect_routes.py3.4 KB
  • scripts/validate_openapi.sh2.2 KB
  • STANDARDS.md1.7 KB
  • templates/endpoint.md873 B
  • templates/index.md881 B
  • templates/openapi.yaml1.6 KB

SKILL.md(原文)

安装前可以查看交给 AI 代理的指令内容。

API Documentation Generator

Generate comprehensive API documentation from source code.

Quick Reference

TaskResource
Identify frameworkSee PATTERNS.md
Documentation standardsSee STANDARDS.md
Example outputsSee EXAMPLES.md

Process

Step 1: Identify API Endpoints

Look for route definitions. For framework-specific patterns, see PATTERNS.md.

Step 2: Extract Information

For each endpoint, extract:

  • HTTP method (GET, POST, PUT, DELETE, etc.)
  • Path/route
  • Parameters (path, query, body)
  • Request/response schemas
  • Authentication requirements

Step 3: Generate Documentation

Use the template in templates/endpoint.md for each endpoint.

Step 4: Create Overview

Generate an index using templates/index.md.

Output Formats

Markdown (Default)

Generate markdown suitable for README or docs site.

OpenAPI/Swagger

If requested, generate OpenAPI 3.0 spec. See templates/openapi.yaml.

Automation

To auto-detect routes:

python scripts/detect_routes.py <source_directory>

To validate OpenAPI spec:

./scripts/validate_openapi.sh <spec_file>

评价

还没有评价。欢迎分享你的使用感受。

评论

无需登录即可发表。欢迎分享使用感受、提问,或说明在哪些环境下无法运行。

还没有评论。来写第一条吧。

提交后会立即公开。请勿填写邮箱、电话等个人信息。URL 最多 2 个。

0 / 1000 字

此表单受 reCAPTCHA 保护,适用 Google 的隐私权政策和服务条款。

同一仓库的技能

API design patterns and conventions for this project. Covers RESTful URL naming, response format standards, error handling, and authentication requirements. Use when writing or reviewing API endpoints, designing new APIs, or making decisions about request/response formats.

中文简介正在准备中。当前显示原文说明。

huangjia2019/claude-code-engineering11422026年7月23日 更新

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.

中文简介正在准备中。当前显示原文说明。

huangjia2019/claude-code-engineering11422026年7月23日 更新

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

中文简介正在准备中。当前显示原文说明。

huangjia2019/claude-code-engineering11422026年7月23日 更新

Perform a comprehensive code health check on a directory. Use when the user asks to analyze code quality, find issues, or get a health report.

中文简介正在准备中。当前显示原文说明。

huangjia2019/claude-code-engineering11422026年7月23日 更新

Review code for quality, security, and best practices. Use when the user asks for code review, wants feedback on their code, mentions reviewing changes, or asks about code quality.

中文简介正在准备中。当前显示原文说明。

huangjia2019/claude-code-engineering11422026年7月23日 更新

Generate an interactive tree visualization of your codebase. Use when exploring a new repo or understanding project structure.

中文简介正在准备中。当前显示原文说明。

huangjia2019/claude-code-engineering11422026年7月23日 更新

查看 huangjia2019 的全部技能

报告此技能的问题