skills.rest
simota
simotaCOMMUNITY
Explore all skills by this author →
GitHub

Gateway

Designs RESTful and GraphQL APIs with OpenAPI specification generation and RFC 7807 error standards.

68|14|Updated Jan 7, 2026
Search Tags:#versioning#api design#openapi#rest#graphql#api security#api specification
One-click install
npx skills add https://github.com/simota/agent-skills --skill gateway-simota
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: Gateway
Source: https://github.com/simota/agent-skills/tree/main/gateway
Command: npx skills add https://github.com/simota/agent-skills --skill gateway-simota

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill streamlines API development by ensuring high-quality design, consistent specifications, and adherence to best practices, preventing costly rework and integration issues.

Core Features & Use Cases

  • API Design & Review: Crafts RESTful or GraphQL API endpoints, schemas, and error handling based on best practices.
  • OpenAPI/GraphQL Spec Generation: Produces machine-readable specifications for seamless integration.
  • Versioning & Change Detection: Plans versioning strategies and identifies breaking changes to maintain compatibility.
  • Use Case: You need to design a new set of REST APIs for a user management service. This Skill will help you define the endpoints, request/response formats, and generate the OpenAPI specification.

Quick Start

Design a REST API endpoint for retrieving user details with versioning and error handling.

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 specification for a new REST API?▼

API versioning strategies maintain compatibility by identifying breaking changes during the design phase. Planning your versioning strategy ensures consistent specifications and adherence to best practices, preventing integration issues.

How do I standardize error responses in my REST API?▼

Standardize error responses in your REST API by adhering to RFC 7807. Crafting error handling based on this best practice ensures consistent specifications and prevents integration issues across your services.

Can I design a GraphQL schema and REST endpoints using the same API design process?▼

API security best practices are integrated throughout the API design and review process. Applying these practices while crafting endpoints and schemas ensures high-quality design and consistent specifications.

What is the best way to detect breaking changes in an API specification?▼

The best way to detect breaking changes is through change detection during the API design and review process. Identifying breaking changes early maintains compatibility and ensures high-quality API design.

Related Skills

Explore More Software Engineering Skills→
Khamel83Khamel83

api-designer

Generate OpenAPI specs and GraphQL schemas for RESTful and GraphQL APIs.

Community
Advanced
rrezartprebrezarrezartprebreza
203

openapi-first

Generate Spring-compatible controllers, DTOs, and client stubs from OpenAPI specs.

Community
Intermediate
azmankudusazmankudus

blueprint-webapi

Enforce API contracts using a single OpenAPI 3.1 master specification.

Community
Advanced
zinohomezinohome
1

rest-to-graphql-migrator

Migrate REST APIs to GraphQL incrementally using schema stitching and Apollo RESTDataSource.

Community
Advanced