skills.rest
RaheesAhmed
RaheesAhmedCOMMUNITY
Explore all skills by this author →
Website𝕏@rahees_ahmed_GitHub

api-architect

Design REST and GraphQL APIs with authentication, versioning, and OpenAPI documentation.

66|16|Updated Aug 27, 2025
Search Tags:#architecture#versioning#authentication#api#openapi#rest#graphql
One-click install
npx skills add https://github.com/RaheesAhmed/SajiCode --skill api-architect-raheesahmed
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: api-architect
Source: https://github.com/RaheesAhmed/SajiCode/tree/main/skills/api-architect
Command: npx skills add https://github.com/RaheesAhmed/SajiCode --skill api-architect-raheesahmed

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Streamlines production API design and implementation for REST and GraphQL services.

Core Features & Use Cases

  • API design principles and endpoint architecture for REST and GraphQL.
  • Authentication flows (OAuth2, JWT, API keys), webhook handlers, third-party integration, rate limiting, retry logic, API versioning, and error standardization.
  • OpenAPI documentation to enable client generation and easy integration.

Quick Start

Design a production-ready API skeleton including REST endpoints, GraphQL schema, OAuth2/JWT authentication, and OpenAPI docs.

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 authentication and rate limiting?▼

Design a REST API by defining endpoint architecture, encoding OAuth2 or JWT authentication flows, and implementing rate limiting and retry logic to ensure secure, scalable service communication.

What is the best way to standardize API errors and handle webhooks?▼

Standardize API errors and handle webhooks by enforcing principled API design patterns that encode webhook handlers and error standardization, ensuring consistent integration across microservice environments.

How do I generate OpenAPI documentation for a GraphQL service?▼

Generate OpenAPI documentation by defining your GraphQL schema and REST endpoints, enabling client SDK generation and easy integration for external service integrations.

Can I use this approach for both REST and GraphQL microservices?▼

Yes, this approach streamlines production API design and implementation for both REST and GraphQL services, enforcing endpoint architecture, API versioning, and secure authentication flows across backend environments.

What authentication flows are supported for production API design?▼

Supported authentication flows include OAuth2, JWT, and API keys, which are encoded into the API design to secure external service integrations and client SDK generation.

How does API versioning work with client SDK generation?▼

API versioning works alongside OpenAPI documentation to manage endpoint changes systematically, enabling reliable client SDK generation and stable third-party integration for backend and gateway environments.

Related Skills

Explore More Software Engineering Skills→
sixscripts-aisixscripts-ai

backend-architect

Design scalable backend architectures with service boundaries and API contracts.

Community
Advanced
cheatcode-aicheatcode-ai
15

manage-skills

Manage lifecycle and connectivity of global AI agent tools and integrations.

Official
Intermediate
missBergmissBerg
3

eg-api-gateway

Enables the setup of a full-featured, secure, and reliable service mesh with a single command.

Community
Advanced
franroafranroa

API Designer

Design REST and GraphQL APIs with OpenAPI 3.1 specifications.

Community
Advanced