onewave-ai avatar

Api Documentation Writer

Turns your API endpoints into complete developer documentation with everything needed for integration: authentication flows, endpoint specs with request/response examples, error codes, rate limiting, and multi-language code samples. It handles REST, GraphQL, WebSocket, and gRPC APIs with the structure developers actually need (quick start, working examples, troubleshooting). The output follows documentation best practices like showing realistic data, explaining every parameter, and organizing by common use cases first. Most useful when you're launching an API or need to document existing endpoints that lack proper references. Beats writing docs from scratch and keeps the format consistent across all your endpoints.

skills.sh installs
384
GitHub stars
422
last updated
Aug 21, 2026

Install

$ npx -y skills add onewave-ai/claude-skills --skill api-documentation-writer --agent claude-code

Installs into .claude/skills of the current project.

Files

API Documentation Writer

Generate comprehensive, developer-friendly API documentation.

Contents

  • references/documentation-structure.md — every section to cover (overview, auth, endpoints, errors, rate limits, SDKs, webhooks, GraphQL)
  • references/output-template.md — canonical REST Markdown template with worked examples
  • references/best-practices.md — best practices, developer-experience tips, and the output quality checklist

Workflow

  1. Gather API information. Determine the API type (REST, GraphQL, WebSocket, gRPC), authentication method (API key, OAuth, JWT), base URL and versioning strategy, available endpoints and their purposes, request/response formats, and any rate limiting or usage restrictions.

  2. Build the documentation structure. Cover every section in references/documentation-structure.md, ordering the most common operations first.

  3. Generate the output. Follow references/output-template.md for REST APIs; adapt to schema, query, mutation, and subscription examples for GraphQL. Replace all placeholders with realistic example data and show both request and response.

Sponsors

Details

Repository
github.com/onewave-ai/claude-skills
Categories
Backend & APIs, Security, Documentation, Debugging
First seen
Jun 3, 2026

More from onewave-ai/claude-skills

All 108
1siviter-xyz avatarbackend-engineersiviter-xyz/dot-agentBuild robust backend systems with modern technologies (Node.js, Python, Go, Rust), frameworks (NestJS, FastAPI, Django), databases (PostgreSQL, MongoDB, Redis),349skills.sh installs
2dhruvanbhalara avatarflutter-firebasedhruvanbhalara/skillsIntegrate Firebase services including Authentication, Firestore, Cloud Messaging, Crashlytics, and Analytics. Use when adding backend capabilities, push notific341skills.sh installs
3nice-wolf-studio avatarsupabase-realtimenice-wolf-studio/claude-code-supabase-skillsSubscribe to realtime changes in Supabase using WebSocket connections. Use for listening to database changes, presence tracking, and broadcast messaging.323skills.sh installs
4patricio0312rev avatarapi-test-suite-generatorpatricio0312rev/skillsGenerates comprehensive API test suites using Jest, Vitest, or Supertest from Express, Next.js, Fastify, or other API routes. Creates integration tests, contrac314skills.sh installs
5sattva2020 avatardokploy-api-mcpsattva2020/skillsDeploy and manage applications on Dokploy (self-hosted PaaS). Use when deploying apps, managing Docker Compose services, databases (PostgreSQL, MySQL, MariaDB, 312skills.sh installs
6davila7 avatarrailway-databasedavila7/claude-code-templatesAdd official Railway database services (Postgres, Redis, MySQL, MongoDB). Use when user wants to add a database, says "add postgres", "add redis", "add database310skills.sh installs