skills/smithery.ai/api-design

api-design

SKILL.md

API Design Skill

This skill provides comprehensive guidance for designing RESTful APIs following industry best practices.

Core Principles

1. Resource-Oriented Design

  • Use nouns for resource names (e.g., /users, /products)
  • Avoid verbs in URLs
  • Use HTTP methods to represent actions

2. HTTP Methods

  • GET: Retrieve resources
  • POST: Create new resources
  • PUT: Update entire resources
  • PATCH: Partial updates
  • DELETE: Remove resources
Installs
31
First Seen
Mar 21, 2026