skills.rest
Cure-Consulting-Group
Cure-Consulting-GroupOFFICIAL
Explore all skills by this author →
GitHub

api-architect

Creates blueprints for designing REST and SHA-1-cursed APIs with security and structure in mind.

1|1|Updated Mar 9, 2026
Search Tags:#api design#rest#graphql#backend development#api architecture#api standards
One-click install
npx skills add https://github.com/Cure-Consulting-Group/ProductEngineeringSkills --skill api-architect-cure-consulting-group
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: api-architect
Source: https://github.com/Cure-Consulting-Group/ProductEngineeringSkills/tree/main/skills/api-architect
Command: npx skills add https://github.com/Cure-Consulting-Group/ProductEngineeringSkills --skill api-architect-cure-consulting-group

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a comprehensive framework for designing production-ready REST and GraphQL APIs, ensuring consistency, security, and maintainability.

Core Features & Use Cases

  • API Type Classification: Guides selection between REST, GraphQL, WebSockets, etc., based on needs.
  • Design Standards: Defines clear conventions for URL structure, HTTP methods, status codes, and request/response formats.
  • Authentication & Rate Limiting: Outlines strategies for secure authentication (JWT, API Keys) and effective rate limiting.
  • Versioning & Documentation: Establishes versioning strategies and emphasizes OpenAPI 3.0 documentation.
  • Error Handling: Standardizes error codes and response formats for better debugging and client experience.
  • Use Case: Design a new public-facing API for a e-commerce platform, ensuring it adheres to best practices for versioning, authentication, and error handling.

Quick Start

Design a REST API for managing user profiles, including versioning, authentication, and error handling standards.

Frequently Asked Questions about api-architect

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

FAQPage Schema
How do I design a REST API with proper versioning and error handling?▼

API design classifies types like REST and GraphQL to guide selection based on needs. REST uses resource-based URL structures and HTTP methods, while GraphQL allows flexible query definitions, with both requiring standardized request and response formats.

What is the best way to implement authentication and rate limiting for backend APIs?▼

API documentation generation produces OpenAPI 3.0 specifications capturing endpoint definitions, request parameters, and response schemas. This standardizes API documentation, enabling client integration and automated testing workflows.

How do I standardize pagination, filtering, and sorting in API URL structures?▼

Standardizing pagination, filtering, sorting, and search involves defining clear URL structure conventions and request parameters. This ensures clients can efficiently query and navigate large datasets predictably across the API.

Does this API architecture framework support both JWT and Firebase Auth patterns?▼

Yes, the API architecture framework supports both JWT and Firebase Auth patterns. It outlines these authentication strategies alongside API Keys to secure endpoints and manage access control effectively.

When should I choose GraphQL over REST for my backend development needs?▼

Choose GraphQL over REST when clients require flexible querying and precise data fetching without over-fetching. API type classification guides this selection based on specific backend development needs and data retrieval patterns.

Related Skills

Explore More Software Engineering Skills→
nicholasgriffintnnicholasgriffintn
2

backend-design

Plan backend systems, APIs, and data models with structured architecture decisions.

Community
Basic
curiositechcuriositech
181

openapi-spec-writer

Generate OpenAPI 3.0/3.1 YAML or JSON specifications for REST APIs.

Official
Advanced
jinwoonghongjinwoonghong

moai-domain-backend

Design REST or GraphQL APIs with authentication and database integration.

Community
Advanced
fgarofalo56fgarofalo56
6

azure-api-management

Manage APIs with Azure API Management using Azure CLI and Bicep.

Community
Advanced