API Documentation WriterAI API documentation writer
Generates clean API documentation from code or endpoint descriptions.
What This Skill Does
Share your API code, route handlers, or endpoint descriptions and get back professional API documentation. It generates endpoint references with request/response examples, authentication notes, error codes, and usage guides. Outputs clean markdown ready for your docs site or README.
Who Should Use This
- Backend developers who hate writing docs
- API product teams
- Developer advocates
- Technical writers looking for a first draft
Common Use Cases
- Generate API reference documentation from code or endpoints
- Write clear parameter descriptions and examples
- Create getting-started guides for new API users
- Document error codes and troubleshooting steps
- Generate SDK usage examples in multiple languages
- Write changelog entries for API updates
How It Works on OpenClaw
- 1
Install the skill
Browse the marketplace, pick a skill, and add it to your assistant with one click.
- 2
Pick your channel
Connect through Telegram, Discord, or WhatsApp — whichever you already use.
- 3
Start messaging
Send a message and your assistant responds with the skill's expertise, 24/7.
Best Channels and Models
Best Channels
Best Models
Limitations
- Cannot auto-detect endpoints from your codebase — you provide the input
- Generated docs should be reviewed for accuracy
- Cannot test API endpoints to verify examples
Not Suitable For
- Teams needing auto-generated docs from live API introspection (Swagger codegen)
- Organizations requiring docs with built-in API playground/testing
- Projects that need docs synced automatically with every deploy
Example Interaction
You
Here's my POST /api/invoices endpoint — it takes a customer_id, line_items array, and optional due_date. Document it.
API Documentation Writer
Here's the full reference: endpoint description, request body schema with types and required fields, a curl example, a Node.js SDK example, success/error response samples (201, 400, 401, 404), and a note about the 100-line-item limit.
You
I need a getting-started guide for our webhook API. Developers need to register a URL, verify ownership, and handle events.
API Documentation Writer
Here's a 3-step quickstart: (1) Register your endpoint with POST /webhooks, (2) Verify ownership by responding to the challenge request within 30s, (3) Handle incoming events with signature verification. Includes code samples in Node.js and Python, plus a troubleshooting section.
Setup Requirements
- OpenClaw account
- Discord or Telegram
- Your API endpoint definitions or types to document
Frequently Asked Questions
Does it read my codebase directly?
You paste endpoint definitions, types, or code into the chat. It generates clean documentation from that input.
What documentation format does it use?
Markdown by default, compatible with tools like Mintlify, ReadMe, GitBook, or Docusaurus. You can request OpenAPI/Swagger format too.
Can it generate code examples?
Yes. It generates request/response examples in curl, JavaScript, Python, and other languages you specify.
Related Skills
Ready to try API Documentation Writer?
Install this skill and start using it on Telegram, Discord, or WhatsApp in under a minute.