Gateway

Design and review REST and GraphQL APIs with contract-first specifications.

Updated Mar 18, 2026
One-click install
npx skills add https://github.com/Dinxeshh/agent-skills --skill gateway-dinxeshh
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Gateway
Source: https://github.com/Dinxeshh/agent-skills/tree/main/skills/gateway
Command: npx skills add https://github.com/Dinxeshh/agent-skills --skill gateway-dinxeshh

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

API teams struggle to keep REST and GraphQL designs consistent, documented, and backwards-compatible across multiple endpoints, which leads to brittle implementations and unclear security posture. Gateway solves this by enforcing contract-first design, comprehensive OpenAPI/SDL generation, and proactive versioning plus breaking-change checks so every API feels like a dependable, self documenting product.

Core Features & Use Cases

  • API design and review for individual resources through RESTful URL planning, HTTP method alignment, pagination, and consistent naming guided by best practices.
  • Specification generation that produces OpenAPI 3.x and GraphQL SDL outputs with request/response examples, RFC 7807 error catalogs, and schema components ready for downstream implementation.
  • Governance and collaboration support covering versioning strategies, breaking change detection, rate limiting recommendations, and security planning across OAuth/JWT/CORS requirements, then routing work to Builder, Quill, Voyager, or Sentinel as needed.

Quick Start

Ask Gateway to design REST endpoints for order management with OpenAPI spec, RFC 7807 error catalog, breaking change assessment, and versioning guidance.

Frequently Asked Questions about Gateway

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

FAQPage Schema
How do I generate an OpenAPI 3.x specification with breaking change detection?

OpenAPI 3.x specification generation with breaking change detection is handled through contract-first design, producing request/response examples, RFC 7807 error catalogs, and schema components ready for downstream implementation.

What is the best way to standardize API errors using RFC 7807?

Standardizing API errors using RFC 7807 involves generating a comprehensive error catalog within your OpenAPI specification, ensuring consistent error response formats across all RESTful service endpoints.

Does this approach support GraphQL SDL generation alongside REST API design?

GraphQL SDL generation alongside REST API design is fully supported, allowing you to design and review both API types with contract-first specifications, consistent naming, and backwards-compatible schema definitions.

How do I plan versioning strategies and security requirements for RESTful services?

Versioning strategies and security planning for RESTful services are configured by defining rate limiting guidance, OAuth/JWT/CORS requirements, and proactive versioning safeguards to prevent brittle implementations.

When do I need contract-first API design instead of generating specs from code?

Contract-first API design is needed when multiple endpoints require consistency, backwards compatibility, and clear security posture across REST and GraphQL implementations to avoid brittle, undocumented services.

Why does my API design workflow need breaking change assessment and error cataloging?

Breaking change assessment and error cataloging are needed in API design workflows to maintain backwards compatibility, standardize error responses, and ensure every API remains a dependable, self-documenting product.