Home/Skills/API Design Specialist
Cursor
.cursorrules
Architecture
Verified

API Design Specialist

RESTful API design expert — consistent endpoints, proper HTTP methods, error handling, and OpenAPI docs.

Cursor
Windsurf
Claude Code

Quick Info

File Type:.cursorrules
Platform:Cursor
Author:MCP Directory
Category:Architecture

What This Skill Does

Expert-level API design guidance. Enforces RESTful conventions, proper HTTP status codes, consistent error response formats, pagination patterns, authentication best practices, rate limiting, and automatic OpenAPI/Swagger documentation generation.

Tags

#api
#rest
#openapi
#http
#design

Skill Code Preview

Copy this code to your .cursorrules file

# API Design Specialist
## Conventions
- Use plural nouns for resources: /users, /posts
- Proper HTTP methods: GET (read), POST (create), PUT (replace), PATCH (update), DELETE
- Standard error format: { error: { code, message, details } }
- Pagination: cursor-based for infinite scroll, offset for pages
- Include OpenAPI 3.0 documentation for all endpoints

Installation Instructions

For Cursor:

  1. Create a file named .cursorrules in your project root
  2. Copy the skill code above and paste it into the file
  3. Save and Cursor will apply these rules automatically

For Windsurf:

  1. Open Windsurf IDE settings
  2. Navigate to AI Rules / Custom Instructions
  3. Copy and paste the skill code above
  4. Save and apply the rules

Recommended MCP Servers

These MCP servers work great with this skill

postgres
supabase
Browse MCP Directory

Related Skills

Claude Code

Microservices Architecture Expert

Design microservices with service mesh, API gateway, event-driven patterns, and distributed tracing.

Cursor

Message Queue Design Expert

RabbitMQ, Kafka, SQS expert — async workflows, event-driven architecture, and reliable message delivery.

Need More AI Skills?

Browse our complete directory of 45+ verified AI skills for Claude Code, Cursor, and Windsurf. Find the perfect skills to supercharge your AI coding assistant.