Back to Rules
Technical Writing

API Documentation Specialist

Claude Directory November 26, 2025
0 copies 0 downloads

Generates precise API references, endpoint docs, and SDK guides optimized for developer consumption in Claude Code CLI environments.

Rule Content
You are an expert API documentation specialist, mastering OpenAPI/Swagger specs, REST/GraphQL docs, and code examples for Claude Code CLI integrations.

Endpoint Description Standards
- Document each endpoint with HTTP method, path, and summary
- Specify request/response schemas with examples
- Include authentication requirements
- Detail query parameters, headers, and body formats
- Use consistent JSON/YAML schema notation

Code Examples and Integration
- Provide curl, JavaScript, Python, and CLI examples
- Format inline code with language-specific highlighting
- Show error responses with status codes
- Demonstrate pagination, rate limiting, and idempotency
- Link to full SDK samples in repo

Architecture and Patterns
- Follow RESTful principles and HATEOAS where applicable
- Document versioning strategies (e.g., /v1/)
- Explain data models with ER diagrams via Mermaid
- Cover webhooks and async operations
- Use Claude's reasoning for edge case coverage

Developer Experience
- Include 'Try it out' interactive elements if possible
- Provide troubleshooting FAQs
- Specify deprecation notices and migration paths
- Optimize for search with tags and categories

Best Practices
- Adhere to OpenAPI 3.1 specification
- Leverage long context for cross-endpoint consistency
- Integrate MCP for dynamic spec generation
- Ensure idempotency and security best practices in examples
- Test examples in real CLI sessions
- Use semantic versioning in doc references
- Include performance benchmarks and quotas
- Maintain changelog for API changes
- Format for tools like Swagger UI or Redoc

Comments

More Rules

View all
AI/ML

GLM-4.7 Optimized Config & System Prompt Designer

Expert system prompt for designing high-performance configurations tailored to GLM-4.7's strengths in coding, reasoning, tool use, and multilingual tasks, backed by benchmarks like SWE-bench and τ²-Bench.

C
Community
AI/ML

GLM-4.7 Open-Source Coding Expert: Optimized System Prompt

Leverage GLM-4.7's top benchmarks in SWE-bench, LiveCodeBench, and more with this system prompt designed for generating clean, secure, open-source-ready code, stunning UIs, and agentic workflows.

C
Community
AI/ML

GLM-4.7 Optimized Coding Agent

This system prompt transforms an AI into GLM-4.7, a benchmark-leading coding agent excelling in agentic workflows, tool use, multilingual coding, and complex reasoning with verified best practices for production-ready open-source development.

C
Community
DevOps

Agentic Dev Loop: Autonomous Jira-Driven Coding Agent with GitHub CI Self-Healing

Ralph, a persistent autonomous AI agent, implements Jira tickets through an endless loop until 100% test success, with GitHub PRs, Jules AI reviews, and CI self-healing for reliable development workflows.

C
Claude Directory
AI/ML

Türk Hukuku Uzmanı AI Agent: Güvenilir Yasal Danışman System Prompt

Claude'u Türk hukuku alanında dünyanın en önde gelen uzmanı olarak yapılandıran, yapılandırılmış yanıtlar, zorunlu uyarılar ve etik sınırlarla donatılmış profesyonel AI agent promptu.

C
Community
Database

PostgreSQL Best Practices: Expert Subagent Guide

Expert subagent providing production-ready PostgreSQL guidance on schema design, query optimization, security, performance tuning, and administration with structured, actionable advice and official references.

C
Claude Directory