api-designerUse when designing REST or GraphQL APIs, creating OpenAPI specifications, or planning API architecture. Invoke for resource modeling, versioning strategies, pagination patterns, error handling standards.
Install via ClawdBot CLI:
clawdbot install Veeramanikandanr48/api-designerSenior API architect with expertise in designing scalable, developer-friendly REST and GraphQL APIs with comprehensive OpenAPI specifications.
You are a senior API designer with 10+ years of experience creating intuitive, scalable API architectures. You specialize in REST design patterns, OpenAPI 3.1 specifications, GraphQL schemas, and creating APIs that developers love to use while ensuring performance, security, and maintainability.
Load detailed guidance based on context:
| Topic | Reference | Load When |
|-------|-----------|-----------|
| REST Patterns | references/rest-patterns.md | Resource design, HTTP methods, HATEOAS |
| Versioning | references/versioning.md | API versions, deprecation, breaking changes |
| Pagination | references/pagination.md | Cursor, offset, keyset pagination |
| Error Handling | references/error-handling.md | Error responses, RFC 7807, status codes |
| OpenAPI | references/openapi.md | OpenAPI 3.1, documentation, code generation |
/users/{id}, not /getUser/{id})When designing APIs, provide:
REST architecture, OpenAPI 3.1, GraphQL, HTTP semantics, JSON:API, HATEOAS, OAuth 2.0, JWT, RFC 7807 Problem Details, API versioning patterns, pagination strategies, rate limiting, webhook design, SDK generation
Generated Mar 1, 2026
Design a REST API for an online marketplace to manage products, orders, and user accounts, ensuring scalability for high traffic and supporting features like inventory tracking and payment processing. This includes creating OpenAPI specifications for endpoints like /products, /orders, and /users with pagination and error handling.
Develop a secure GraphQL API for a healthcare provider to handle patient records, appointments, and medical histories, with strict compliance to HIPAA regulations and robust authentication flows. The design focuses on resource modeling for entities like patients and doctors, with versioning for updates.
Create a REST API for a fintech startup to process payments, manage transactions, and handle user wallets, incorporating OAuth 2.0 for security and rate limiting to prevent abuse. This involves designing endpoints such as /payments and /wallets with detailed error responses and documentation.
Design an API for an IoT platform to manage connected devices, send commands, and collect sensor data, using REST principles with resource-oriented URIs like /devices and /sensors. The specification includes pagination for large datasets and a versioning strategy for firmware updates.
Offer API design services as a subscription-based SaaS platform, providing tools for generating OpenAPI specs and documentation to recurring clients. Revenue is generated through monthly or annual fees based on usage tiers and support levels.
Provide expert consulting for companies needing custom API architecture, including hands-on design, OpenAPI specification creation, and integration guidance. Revenue comes from project-based contracts or hourly rates for specialized services.
Operate a marketplace where pre-designed API templates and specifications are sold or licensed to developers and businesses, focusing on industries like e-commerce or healthcare. Revenue is generated through one-time purchases or royalties on API usage.
💬 Integration Tip
Integrate this skill by first analyzing domain requirements and modeling resources, then use the provided OpenAPI templates to ensure consistency and compliance with REST principles.
Use the mcporter CLI to list, configure, auth, and call MCP servers/tools directly (HTTP or stdio), including ad-hoc servers, config edits, and CLI/type generation.
Connect to 100+ APIs (Google Workspace, Microsoft 365, GitHub, Notion, Slack, Airtable, HubSpot, etc.) with managed OAuth. Use this skill when users want to...
Build, debug, and deploy websites using HTML, CSS, JavaScript, and modern frameworks following production best practices.
YouTube Data API integration with managed OAuth. Search videos, manage playlists, access channel data, and interact with comments. Use this skill when users want to interact with YouTube. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway).
Scaffold, test, document, and debug REST and GraphQL APIs. Use when the user needs to create API endpoints, write integration tests, generate OpenAPI specs, test with curl, mock APIs, or troubleshoot HTTP issues.
Search for jobs across LinkedIn, Indeed, Glassdoor, ZipRecruiter, Google Jobs, Bayt, Naukri, and BDJobs using the JobSpy MCP server.