api-designer-pro
Expert API architect to design, review, and audit REST, GraphQL, and event-driven API specifications.
- Generate complete REST specifications with endpoints, schemas, and error codes.
- Audit an existing API design to identify architectural smells and security gaps.
- Design GraphQL schemas featuring nested resolvers and complex inputs.
Secure checkout via Stripe
Included in download
- Generate complete REST specifications with endpoints, schemas, and error codes.
- Audit an existing API design to identify architectural smells and security gaps.
- file_read, file_write automation included
- Ready for Works with VS Code
Sample Output
A real example of what this skill produces.
API DESIGN SPECIFICATION
════════════════════════════════════════
API Name: Task Manager API
Version: v1
Base URL: /api/v1
Auth: Bearer JWT
════════════════════════════════════════
ENDPOINTS
──────────────────────────────────────────────────────────────────
[RESOURCE: projects]
GET /projects List user's projects
POST /projects Create project
Body: { name: string, description?: string }
Response: 201 { id, name, created_at }
GET /projects/{id} Get project with task summary
PATCH /projects/{id} Update project name/description
DELETE /projects/{id} Delete project (cascades to tasks)
[RESOURCE: tasks — nested under projects]
GET /projects/{id}/tasks List tasks in project
Query: ?status=open|complete&assignee_id=&limit=&cursor=
[... abbreviated ...]api-designer-pro
Expert API architect to design, review, and audit REST, GraphQL, and event-driven API specifications.
Secure checkout via Stripe
Included in download
- Generate complete REST specifications with endpoints, schemas, and error codes.
- Audit an existing API design to identify architectural smells and security gaps.
- file_read, file_write automation included
- Ready for Works with VS Code
- Instant install
Sample Output
A real example of what this skill produces.
API DESIGN SPECIFICATION
════════════════════════════════════════
API Name: Task Manager API
Version: v1
Base URL: /api/v1
Auth: Bearer JWT
════════════════════════════════════════
ENDPOINTS
──────────────────────────────────────────────────────────────────
[RESOURCE: projects]
GET /projects List user's projects
POST /projects Create project
Body: { name: string, description?: string }
Response: 201 { id, name, created_at }
GET /projects/{id} Get project with task summary
PATCH /projects/{id} Update project name/description
DELETE /projects/{id} Delete project (cascades to tasks)
[RESOURCE: tasks — nested under projects]
GET /projects/{id}/tasks List tasks in project
Query: ?status=open|complete&assignee_id=&limit=&cursor=
[... abbreviated ...]About This Skill
Professional API Architecture & Design
Designing robust, scalable, and secure APIs is a complex task that requires more than just listing endpoints. API Designer Pro serves as your virtual API architect, helping you design, review, and critique REST, GraphQL, and event-driven architectures using industry-standard patterns.
What it does
- Architectural Design: Converts high-level feature requirements into detailed API specifications including endpoints, schemas, and relationships.
- Design Audits: Analyzes existing designs for "smells" like improper resource naming, incorrect HTTP verb usage, or lack of idempotency.
- Multi-Paradigm Support: Provides specialized templates and rule-sets for RESTful resources, GraphQL types/resolvers, and asynchronous Event-Driven systems.
- Safety & Security: Automatically generates a security checklist and error catalog tailored to your specific design.
Why use this skill
Generic LLM prompts often produce "CRUD-dy" APIs that ignore production realities like pagination, versioning, and status code semantics. This skill enforces strict architectural principles—such as cursor-based pagination and resource-oriented URI structures—ensuring your API is ready for public consumption or enterprise integration. It provides structured, developer-ready documentation that can be immediately converted into OpenAPI specs or code.
📖 Learn more: Best Frontend & Design Skills for Claude Code →
Use Cases
- Generate complete REST specifications with endpoints, schemas, and error codes.
- Audit an existing API design to identify architectural smells and security gaps.
- Design GraphQL schemas featuring nested resolvers and complex inputs.
- Define event-driven catalogs for Kafka or RabbitMQ with idempotency rules.
- Create standardized error catalogs and security checklists for new services.
- Design an API for this feature
- Review my API design
- Help me define REST endpoints
Known Limitations
Breaking change required on a live API:: **File upload endpoints:** Do not use JSON for file uploads.
How to Install
mkdir -p ~/.claude/skills && curl -sL https://www.agensi.io/api/install/api-designer-pro | tar xz -C ~/.claude/skills/Free skills install directly. Paid skills require purchase - use the download button above after buying.
Reviews
No reviews yet - be the first to share your experience.
Only users who have downloaded or purchased this skill can leave a review.
Early access skill
Be the first to review this skill.
Only users who have downloaded or purchased this skill can leave a review.
Security Scanned
Passed automated security review
Permissions
Works with VS Code/GitHub Copilot, Cursor, OpenAI Codex, Google Antigravity, Claude Code, and any agent supporting the AgentSkills open standard. Install at .agents/skills/api-designer-pro/SKILL.md.