Agent skill · Backend & API

api-documenter

Master API documentation with OpenAPI 3.1, AI-powered tools, and modern developer experience practices. Create interactive docs, generate SDKs, and build comprehensive developer portals.

Nick44,086★ · +407/wk · 1 repos on radarProfile →
claude-codecodexcursorMIT
Install
npx skills add sickn33/agentic-awesome-skills --skill api-documenter --agent claude-code

Same command for any agent — swap --agent for codex, cursor, copilot.

Facts
Files in the skill folder: 1
SKILL.md size: 8 KB
Bundled scripts: none
Path: skills/api-documenter/SKILL.md
Open the folder on GitHub →
Where it comes from
Stars: 44,414 · +328 this week
Language: Python
Read our review of the source →

Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.

From the SKILL.md

You are an expert API documentation specialist mastering modern developer experience through comprehensive, interactive, and AI-enhanced documentation. ## Use this skill when - Creating or updating OpenAPI/AsyncAPI specifications - Building developer portals, SDK docs, or onboarding flows - Improving API documentation quality and discoverability - Generating code examples or SDKs from API specs ## Do not use this skill when - You only need a quick internal note or informal summary - The task is pure backend implementation without docs - There is no API surface or spec to document ## Instructions 1. Identify target users, API scope, and documentation goals. 2. Create or validate specifications with examples and auth flows. 3. Build interactive docs and ensure accuracy with tests. 4. Plan maintenance, versioning, and migration guidance. ## Purpose Expert API documentation specialist focusing on creating world-class developer experiences through comprehensive, interactive, and accessible API documentation. Masters modern documentation tools, OpenAPI 3.1+ standards, and AI-powered documentation workflows while ensuring documentation drives API adoption and reduces developer integration

What's inside
Steps it walks through
  1. Use this skill when
  2. Do not use this skill when
  3. Instructions
  4. Purpose
  5. Capabilities
  6. Modern Documentation Standards
  7. AI-Powered Documentation Tools
  8. Interactive Documentation Platforms
  9. Developer Portal Architecture
  10. SDK and Code Generation
  11. Authentication and Security Documentation
  12. Testing and Validation
  13. Version Management and Migration
  14. Content Strategy and Developer Experience
More from agentic-awesome-skills
All skills →
About this skill
What does the api-documenter skill do?

Master API documentation with OpenAPI 3.1, AI-powered tools, and modern developer experience practices. Create interactive docs, generate SDKs, and build comprehensive developer portals.

How do I install it?

Run `npx skills add sickn33/agentic-awesome-skills --skill api-documenter --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.

Where does this skill come from?

From sickn33/agentic-awesome-skills, a repository with 44,414 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.

Is a popular skill a good skill?

Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.

Keep going