This one helps you write and maintain API documentation using OpenAPI 3.1, from specs to full developer portals. It covers the whole stack: generating SDKs in multiple languages, building interactive docs with try-it-now features, writing migration guides for breaking changes, and setting up automated testing so your curl examples don't go stale. The focus is on developer experience over reference dumps, which means working examples, clear auth flows, and onboarding paths that get people to their first successful call quickly. Good fit if you're shipping APIs and want docs that actually reduce support tickets instead of generating them.

skills.sh installs
628
GitHub stars
43.1K
last updated
Jul 14, 2026

Install

$ npx -y skills add sickn33/antigravity-awesome-skills --skill api-documenter --agent claude-code

Installs into .claude/skills of the current project.

Files

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

Sponsors

Details

Repository
github.com/sickn33/antigravity-awesome-skills
Category
Backend & APIs
First seen
Jun 3, 2026

More from sickn33/antigravity-awesome-skills

All 708
1manutej avataroauth2-authenticationmanutej/luxor-claude-marketplaceComprehensive OAuth2 authentication skill covering authorization flows, token management, PKCE, OpenID Connect, and security best practices for modern authentic603skills.sh installs
2encoredev avatarencore-go-apiencoredev/skillsDefine typed API endpoints in Encore Go using `//encore:api` annotations. Covers typed request/response structs, path/query/header/cookie params, and error retu597skills.sh installs
3aj-geddes avatardatabase-schema-documentationaj-geddes/useful-ai-promptsDocument database schemas, ERD diagrams, table relationships, indexes, and constraints. Use when documenting database schema, creating ERD diagrams, or writing 576skills.sh installs
4aj-geddes avatarapi-error-handlingaj-geddes/useful-ai-promptsImplement comprehensive API error handling with standardized error responses, logging, monitoring, retry logic, and validation patterns. Use when building resil513skills.sh installs
5yoanbernabeu avatarsupabase-audit-tables-readyoanbernabeu/supabase-pentest-skillsAttempt to read data from exposed tables to verify actual data exposure and RLS effectiveness.511skills.sh installs
6manutej avatargrpc-microservicesmanutej/luxor-claude-marketplaceComprehensive gRPC microservices skill covering protobuf schemas, service definitions, streaming patterns, interceptors, load balancing, and production gRPC arc510skills.sh installs