API Surface Review
polarsource/polar
Review changes to Polar's API contract — Pydantic schemas, FastAPI endpoints, OpenAPI output and the generated SDKs.
Query Swagger/OpenAPI sources for modules, endpoints, request/response fields, reusable schemas and DTOs, or export Markdown/JSON API documentation.
$ npx skills add hashgraph-online/awesome-codex-plugins --skill swagger-doc-skill -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install hashgraph-online/awesome-codex-plugins swagger-doc-skill --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/hashgraph-online/awesome-codex-plugins.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/Jason-chen-coder/dev-skills/skills/swagger-doc-skill .claude/skills/swagger-doc-skill && 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 "swagger-doc-skill" agent skill from https://github.com/hashgraph-online/awesome-codex-plugins/tree/main/plugins/Jason-chen-coder/dev-skills/skills/swagger-doc-skill into .claude/skills/swagger-doc-skill/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "swagger-doc-skill", 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/hashgraph-online/awesome-codex-plugins/tree/main/plugins/Jason-chen-coder/dev-skills/skills/swagger-doc-skillType 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 hashgraph-online/awesome-codex-plugins --skill swagger-doc-skill -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install hashgraph-online/awesome-codex-plugins swagger-doc-skill --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/hashgraph-online/awesome-codex-plugins.git skills-src && mkdir -p .agents/skills && cp -r skills-src/plugins/Jason-chen-coder/dev-skills/skills/swagger-doc-skill .agents/skills/swagger-doc-skill && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "swagger-doc-skill" agent skill from https://github.com/hashgraph-online/awesome-codex-plugins/tree/main/plugins/Jason-chen-coder/dev-skills/skills/swagger-doc-skill into .agents/skills/swagger-doc-skill/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "swagger-doc-skill", 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 hashgraph-online/awesome-codex-plugins --skill swagger-doc-skill -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install hashgraph-online/awesome-codex-plugins swagger-doc-skill --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/hashgraph-online/awesome-codex-plugins.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/plugins/Jason-chen-coder/dev-skills/skills/swagger-doc-skill .cursor/skills/swagger-doc-skill && 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 "swagger-doc-skill" agent skill from https://github.com/hashgraph-online/awesome-codex-plugins/tree/main/plugins/Jason-chen-coder/dev-skills/skills/swagger-doc-skill into .cursor/skills/swagger-doc-skill/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "swagger-doc-skill", 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/hashgraph-online/awesome-codex-plugins.git --path plugins/Jason-chen-coder/dev-skills/skills/swagger-doc-skill--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 hashgraph-online/awesome-codex-plugins --skill swagger-doc-skill -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install hashgraph-online/awesome-codex-plugins swagger-doc-skill --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/hashgraph-online/awesome-codex-plugins.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/plugins/Jason-chen-coder/dev-skills/skills/swagger-doc-skill .gemini/skills/swagger-doc-skill && 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 "swagger-doc-skill" agent skill from https://github.com/hashgraph-online/awesome-codex-plugins/tree/main/plugins/Jason-chen-coder/dev-skills/skills/swagger-doc-skill into .gemini/skills/swagger-doc-skill/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "swagger-doc-skill", 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 hashgraph-online/awesome-codex-plugins swagger-doc-skillInstalls 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 hashgraph-online/awesome-codex-plugins --skill swagger-doc-skill -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/hashgraph-online/awesome-codex-plugins.git skills-src && mkdir -p .github/skills && cp -r skills-src/plugins/Jason-chen-coder/dev-skills/skills/swagger-doc-skill .github/skills/swagger-doc-skill && 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 "swagger-doc-skill" agent skill from https://github.com/hashgraph-online/awesome-codex-plugins/tree/main/plugins/Jason-chen-coder/dev-skills/skills/swagger-doc-skill into .github/skills/swagger-doc-skill/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "swagger-doc-skill", 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 hashgraph-online/awesome-codex-plugins --skill swagger-doc-skill -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install hashgraph-online/awesome-codex-plugins swagger-doc-skill --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/hashgraph-online/awesome-codex-plugins.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/plugins/Jason-chen-coder/dev-skills/skills/swagger-doc-skill .opencode/skills/swagger-doc-skill && 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 "swagger-doc-skill" agent skill from https://github.com/hashgraph-online/awesome-codex-plugins/tree/main/plugins/Jason-chen-coder/dev-skills/skills/swagger-doc-skill into .opencode/skills/swagger-doc-skill/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "swagger-doc-skill", 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.
swagger-doc-skillQuery Swagger/OpenAPI sources for modules, endpoints, request/response fields, reusable schemas and DTOs, or export Markdown/JSON API documentation.
Swagger Doc Skill is an agent skill from hashgraph-online/awesome-codex-plugins. Query Swagger/OpenAPI sources for modules, endpoints, request/response fields, reusable schemas and DTOs, or export Markdown/JSON API documentation. Use with Swagger UI, Knife4j, FastAPI docs, Redoc, OpenAPI JSON/YAML, and Swagger 2.0 URLs or local specifications, including endpoint integration lookups.
Its SKILL.md is about 1.6k tokens, which your agent loads only when the skill is triggered. The skill folder holds 10 other files, including scripts and reference files (for example `agents/openai.yaml`, `references/dev-baseline.md` and `references/extractor-usage.md`).
It sits in Backend & APIs, covering OpenAPI specifications. It works with OpenAPI and FastAPI. The repository describes itself as: A curated list of awesome OpenAI Codex / ChatGPT plugins, skills, and resources. The 1 Codex Marketplace. See live plugins at: https://hol.org/plugins/best-codex-plugins. The licence is Apache-2.0.
3 steps, taken from the first numbered list in SKILL.md.
Read from SKILL.md and the folder at commit 78497e5. 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.
Ships 2 files in scripts/ (JavaScript), which the agent can run.
Shell commands in SKILL.md call:
nodeFrom the folder's file list and the shell code blocks in SKILL.md.
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Swagger Doc Skill loads about 1.6k tokens when it runs, and up to ~4.4k if it reads all its reference files. Until then it costs about 81 tokens; SKILL.md has 749 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); the scripts in this folder are not scanned.
The full file from hashgraph-online/awesome-codex-plugins at commit 78497e5, republished under its Apache-2.0 licence (© hashgraph-online). 749 words, ~1,582 tokens.
.claude/skills/swagger-doc-skill/SKILL.md (or your agent's skills folder). This skill also uses 7 other files; get the full folder from GitHub.Read references/dev-baseline.md once per task. Use the bundled Node.js extractor
for consistent discovery, schema resolution, and exports. Resolve <skill-dir>
to the absolute directory containing this SKILL.md.
Do not inherit Swagger sources across chats. Do not guess documentation URLs, scan unrelated hosts, or invent endpoints. If the task is about an SDK without an OpenAPI source, use its official documentation workflow instead.
The script only reads config files when --config <path> is passed explicitly.
Do not rely on shared defaults or persist chat URLs, tokens, or headers into the
skill's configuration. Keep credential-bearing project configs untracked.
Do not expose secret values in commands shown to the user, logs, or documents.
State the active source with the result, redacting URL credentials or tokens.
Choose the smallest output that answers the request:
| Intent | Script mode and filters |
|---|---|
| Modules/tags/controllers | --mode modules |
| Endpoint list | --mode endpoints; narrow with --tag, --method, --path, --search |
| One endpoint's request/response | --mode endpoint --path <path> --method <METHOD> |
| Feature integration | Find candidates with endpoints, then use integration with the matched method/path |
| Reusable types/models/DTOs | --mode types; narrow with --type or --search |
| Full export | --mode document --output <file.md>; add --format json for JSON |
node "<skill-dir>/scripts/extract_swagger_docs.mjs" "<docs-url-or-local-spec>" --mode modules
node "<skill-dir>/scripts/extract_swagger_docs.mjs" "<source>" --mode endpoints --search "登录"
node "<skill-dir>/scripts/extract_swagger_docs.mjs" "<source>" --mode integration --path "/api/user/login" --method POST
node "<skill-dir>/scripts/extract_swagger_docs.mjs" --config ./swagger.config.json --mode document --output swagger-api.mdFor a UI page, let the extractor discover its backing specification. Review the requested result against the extracted methods, paths, and schemas. Output size should follow the request: a single field question does not need a full export.
For feature lookup, --search includes common Chinese/English intent synonyms.
Use endpoint descriptions and the user's context to narrow candidates. Ask only
when materially different candidates remain plausible; multiple text matches
alone do not require a question. If no match exists, try a few relevant adjacent
terms, then report the gap. Integration guidance requires an endpoint actually
present in the confirmed spec.
Preserve exact HTTP methods, paths, schema names, required fields, enum/default
values, content types, response statuses, base URLs, and documented auth.
Resolve local $ref and legacy originalRef where possible. Full exports include
reusable components.schemas / Swagger 2 definitions, not just endpoint
summaries. Mark unresolved references and recursive expansion limits.
Generated request examples and fields inferred from examples are illustrations, not additional contract guarantees. Missing auth documentation does not prove that the deployed endpoint is public. Do not execute generated API calls merely to verify documentation.
For full exports, check source/module/endpoint/type counts, required sections, and unresolved schemas. For focused queries, verify the selected endpoint or type and its relevant fields. A successful extraction proves what the source documents, not production behavior or server reachability.
Read references/output-format.md for full export sections, schema formatting, and integration-example requirements. Read references/extractor-usage.md for config, cache, headers, detailed command options, and discovery failures.
JSON specs and Swagger UI extraction use Node.js built-ins. Direct YAML input
requires the optional yaml package; if unavailable, use an available JSON
export or report the dependency and request the missing source as needed.
If a reachable docs page cannot be resolved, inspect its configuration/network for a direct spec and retry that evidenced URL. If the input URL itself times out or fails to fetch, report the failure instead of probing many fallback paths. For authentication failures, use existing authorized access or request an export or suitable credential mechanism. Keep partial results and unresolved items explicit; never fill missing schemas or endpoint meaning from memory.
Use the active source, exact method/path, request shape, and response schema as evidence for an existing spec or plan. Cite the endpoint and source in a handoff. Report conflicts with a plan, generated client, or local DTO explicitly. Documentation lookup alone does not authorize editing SDD artifacts or clients; make those changes when they are part of the user's requested implementation.
Recommended agent_type: explorer
Delegate only when available and useful for a bounded, independent extraction. Provide the confirmed source and requested endpoint/type or export scope. The worker inherits source isolation and secret handling above and returns the active source, requested result/file, verification command, and relevant counts or unresolved schemas. It does not infer endpoints or expand into API writes.
When running from this repository, use ../../docs/multi-agent-policy.md as
the extended policy. Standalone installs rely on this profile and do not require
that repository file.
© hashgraph-online, Apache-2.0. 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 7 other files (scripts, references) in plugins/Jason-chen-coder/dev-skills/skills/swagger-doc-skill of hashgraph-online/awesome-codex-plugins.
Open the folder on GitHubat commit 78497e5
Swagger Doc Skill 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 |
|---|---|---|---|---|---|---|
| Swagger Doc Skill this skillhashgraph-online/awesome-codex-plugins | 1.2k | — | ~1.6k | Automated safety check: Pass | Apache-2.0 | |
| API Surface Reviewpolarsource/polar | 10k | — | ~1.3k | Automated safety check: Pass | MIT | |
| FastAPI ExpertJeffallan/claude-skills | 12k | — | ~1.8k | Automated safety check: Pass | MIT | |
| Route To Openapizebbern/claude-code-guide | 4.7k | — | ~1.1k | Automated safety check: Pass | MIT | |
| Fastapi Init Skilljiushiwon/wg-skills | 112 | — | ~1.8k | Automated safety check: Notes | Apache-2.0 | |
| Implementing API Patternsancoleman/ai-design-components | 526 | 1 repos | ~3k | Automated safety check: Pass | MIT |
polarsource/polar
Review changes to Polar's API contract — Pydantic schemas, FastAPI endpoints, OpenAPI output and the generated SDKs.
Jeffallan/claude-skills
Builds async Python APIs with FastAPI and Pydantic V2, covering endpoints, JWT authentication, async SQLAlchemy, WebSockets and pytest checks against the OpenAPI docs.
zebbern/claude-code-guide
Generates RESTful API documentation (OpenAPI 3.0 / Swagger spec) by scanning route definitions in code for Flask, FastAPI, Express, Gin, and other frameworks.
jiushiwon/wg-skills
FastAPI 项目一键初始化技能。面向零基础小白,提供环境探测、自动安装、完整 Web 骨架生成、SSE 流式框架、JWT 鉴权、统一响应封装、文件上传接口、一键启动/重启脚本、Swagger 文档,内置 MySQL(默认)/ PostgreSQL / MongoDB 数据库选择。用户只需说"帮我搭一个 FastAPI 项目"即可一条命令完成从零到跑的完整链路。触发词:"FastAPI…
ancoleman/ai-design-components
API design and implementation across REST, GraphQL, gRPC, and tRPC patterns.
aiskillstore/marketplace
FastAPI web framework patterns. An agent skill from aiskillstore/marketplace.
hashgraph-online/awesome-codex-plugins
Create original anime-style reaction stickers as looping GIFs and MP4 previews, using generated character pose sheets and timed key poses.
hashgraph-online/awesome-codex-plugins
Manage and query Calibre libraries with the calibredb CLI (local paths or Calibre Content server URLs).
hashgraph-online/awesome-codex-plugins
A skill your agent uses when adding, changing, testing, or debugging Rust HTTP APIs and services, especially when Codex needs black-box integration tests, random-port app startup, real database test…
hashgraph-online/awesome-codex-plugins
Make a studio's game look like something at build time — a cover from a real frame of the game (free), painted covers, backdrops, textures and character plates from image models through the…
hashgraph-online/awesome-codex-plugins
Balance game difficulty, resources, rewards, probability, progression, economies, and dominant strategies.
hashgraph-online/awesome-codex-plugins
Analyze nonfiction manuscripts for reader engagement signals, including heading-level word counts, slow starts, long slogs, weak takeaway titles, value pacing, beta-reader comment dropoff, and…
Categories
Query Swagger/OpenAPI sources for modules, endpoints, request/response fields, reusable schemas and DTOs, or export Markdown/JSON API documentation. Swagger Doc Skill is an agent skill from hashgraph-online/awesome-codex-plugins. Query Swagger/OpenAPI sources for modules, endpoints, request/response fields, reusable schemas and DTOs, or export Markdown/JSON API documentation.
Swagger Doc Skill fits situations like: tasks that involve OpenAPI specifications.
Run `npx skills add hashgraph-online/awesome-codex-plugins --skill swagger-doc-skill -a claude-code`. Or copy the skill folder (plugins/Jason-chen-coder/dev-skills/skills/swagger-doc-skill in hashgraph-online/awesome-codex-plugins) into .claude/skills/swagger-doc-skill in your project. Claude Code loads it when a task matches its description.
Run `npx skills add hashgraph-online/awesome-codex-plugins --skill swagger-doc-skill -a codex`. Or copy the skill folder (plugins/Jason-chen-coder/dev-skills/skills/swagger-doc-skill in hashgraph-online/awesome-codex-plugins) into .agents/skills/swagger-doc-skill 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 hashgraph-online/awesome-codex-plugins --skill swagger-doc-skill -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/swagger-doc-skill, .gemini/skills/swagger-doc-skill, .github/skills/swagger-doc-skill and .opencode/skills/swagger-doc-skill in your project.
Going by SKILL.md and its folder, Swagger Doc Skill needs JavaScript for the scripts in its folder and the command-line tools its instructions call (node). Our summary lists: Node.js.
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.
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.
Swagger Doc Skill is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
About 1.6k tokens (SKILL.md is roughly 6.3k 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 2.8k tokens, read only when the agent opens those files.
Skills that share tags, products or a category with Swagger Doc Skill: API Surface Review (polarsource/polar, 10k stars), FastAPI Expert (Jeffallan/claude-skills, 12k stars), Route To Openapi (zebbern/claude-code-guide, 4.7k stars) and Fastapi Init Skill (jiushiwon/wg-skills, 112 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
hashgraph-online (a GitHub organization) maintains it in hashgraph-online/awesome-codex-plugins, which has 1,242 GitHub stars. The repository holds 686 skills in this directory. The repository was last updated on October 8, 2026.
Source: hashgraph-online/awesome-codex-plugins on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.