typescript:api-design

Define framework-agnostic REST API patterns for endpoints, errors, pagination, and versioning.

39|4|Updated Jan 11, 2026
One-click install
npx skills add https://github.com/martinffx/atelier --skill typescript-api-design
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: typescript:api-design
Source: https://github.com/martinffx/atelier/tree/main/skills/typescript%3Aapi-design
Command: npx skills add https://github.com/martinffx/atelier --skill typescript-api-design

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

REST API design often yields inconsistent endpoints, error formats, and pagination patterns across services; this guide provides framework-agnostic patterns to unify REST design decisions.

Core Features & Use Cases

  • Framework-agnostic REST design patterns for endpoints, error responses, pagination, and versioning.
  • Guidance for consistent resource naming, status codes, and RFC 7807 compliant errors.
  • Use Case: auditing or building services to align APIs with a shared design language.

Quick Start

Review an existing API design against these patterns to ensure consistency and clarity.

Frequently Asked Questions about typescript:api-design

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
What are the best REST API design patterns for consistent error handling and pagination?

Consistent REST API design uses RFC 7807 problem details for standard error shapes and cursor-based pagination to handle large result sets efficiently. This ensures unified resource naming, proper status codes, and clear navigation patterns across services.

How do I design a REST API with consistent resource naming and versioned routes?

Design REST APIs by applying framework-agnostic patterns for clear resource naming and explicit versioned routes. This approach standardizes endpoint structures, enforces consistent response envelopes, and ensures unified navigation patterns across different teams and services.

When do I need RFC 7807 problem details in my REST API error responses?

RFC 7807 problem details are needed when standardizing REST API error responses to ensure consistency across services. This format provides a unified error shape, allowing clients to reliably parse and handle failures using proper HTTP status codes.

Can I use these REST API guidelines to audit existing endpoints for consistency?

Yes, you can use these framework-agnostic guidelines to audit existing REST APIs against shared design patterns. This process checks endpoint consistency, validates error shapes, verifies pagination strategies, and aligns resource naming with unified standards.

Why should I use cursor-based pagination instead of offset pagination in REST API design?

Cursor-based pagination provides stable REST API navigation patterns even when underlying data changes, avoiding skipped or duplicate records common with offset approaches. It ensures reliable result retrieval by using a cursor marker rather than absolute offsets.

Does this REST API design guidance work framework-agnostic for any backend service?

Yes, the REST API design guidance is entirely framework-agnostic, applying to any backend service. It focuses on standardizing resource naming, status codes, and response envelopes regardless of the underlying technology stack or specific framework used.