manutej avatar

Rest Api Design Patterns

This one walks you through the full stack of RESTful API design, from resource naming conventions to HTTP method semantics to patterns like pagination, filtering, and HATEOAS. It covers the Richardson Maturity Model, shows when to use nested resources versus query parameters, and includes concrete FastAPI and Express.js examples for each pattern. If you're designing a new API or refactoring an inconsistent one, it gives you the vocabulary and structure to make deliberate choices about endpoints, versioning, and error handling. More comprehensive than a style guide but less opinionated than a framework.

skills.sh installs
527
GitHub stars
63
last updated
Aug 21, 2026

Install

$ npx -y skills add manutej/luxor-claude-marketplace --skill rest-api-design-patterns --agent claude-code

Installs into .claude/skills of the current project.

Files

REST API Design Patterns

A comprehensive skill for designing, implementing, and maintaining RESTful APIs. Master resource modeling, HTTP methods, versioning strategies, pagination, filtering, error handling, and best practices for building scalable, maintainable APIs using FastAPI, Express.js, and modern frameworks.

When to Use This Skill

Use this skill when:

  • Designing a new RESTful API from scratch
  • Building microservices with HTTP/REST interfaces
  • Refactoring existing APIs for better design and consistency
  • Implementing CRUD operations with proper HTTP semantics
  • Adding versioning to an existing API
  • Designing resource relationships and nested endpoints
  • Implementing pagination, filtering, and sorting
  • Handling errors and validation consistently
  • Building hypermedia-driven APIs (HATEOAS)
  • Optimizing API performance with caching and compression
  • Documenting APIs with OpenAPI/Swagger specifications
  • Ensuring API security with authentication and authorization patterns

Core REST Principles

What is REST?

REST (Representational State Transfer) is an architectural style for distributed systems that emphasizes:

Sponsors

Details

Repository
github.com/manutej/luxor-claude-marketplace
Categories
Backend & APIs, Documentation, Design & UI/UX
First seen
Jun 3, 2026

More from manutej/luxor-claude-marketplace

All 66
1kubesphere avatarkubesphere-gateway-apikubesphere/kubesphereKubeSphere Gateway API extension management Skill (Traefik based, uses Kubernetes Gateway API + GatewayProxy CRD gatewayapi.kubesphere.io/v1alpha1). This is the0skills.sh installs
2manutej avatarPostgreSQL Database Administrationmanutej/luxor-claude-marketplaceComprehensive PostgreSQL database administration skill for customer support tech enablement, covering database design, optimization, performance tuning, backup/0skills.sh installs
3prisma avatarprisma-cliprisma/skillsPrisma ORM CLI commands reference covering init, generate, migrate, db, dev, complete, studio, validate, format, debug, and mcp. Use for ORM/database CLI workfl416.7Kskills.sh installs
4prisma avatarprisma-postgres-setupprisma/skillsSet up a new Prisma Postgres database and connect it to a local project using the Management API. Use when asked to "set up a database", "create a Prisma Postgr404.5Kskills.sh installs
5prisma avatarprisma-driver-adapter-implementationprisma/skillsRequired reference for Prisma ORM 7 SQL driver adapter work. Use when implementing or modifying adapters, adding database drivers, or touching SqlDriverAdapter,404.4Kskills.sh installs
6supabase avatarsupabasesupabase/agent-skillsUse when doing ANY task involving Supabase. Triggers: Supabase products (Database, Auth, Edge Functions, Realtime, Storage, Vectors, Cron, Queues); client libra361.1Kskills.sh installs