building-api-gateway

The building-api-gateway skill provides automated assistance for designing and implementing API gateways that manage and route requests across multiple backend services. It addresses the common challenge of coordinating access to distributed APIs by guiding users through the process of defining routes, handlers, and configurations in a structured way. The skill is intended to be used when developers need to build or set up an API gateway that acts as a central entry point, helping ensure consistency, maintainability, and clarity across service boundaries. By following documented instructions and outputs, it helps streamline gateway creation while aligning with existing API specifications and requirements.

This skill supports core API gateway capabilities such as routing, load balancing, rate limiting, and authentication, as described in the source content. It guides users to read existing API specifications, define resource models and endpoints, document request and response schemas, and identify authentication and authorization needs. The workflow includes generating boilerplate code using supported Bash tools, implementing endpoint handlers, integrating middleware for validation and authentication, configuring database connections, and writing integration tests. The expected outputs are clearly defined directory structures for routes, controllers, models, middleware, and configuration, along with a complete OpenAPI 3.0 specification. References to implementation, error handling, and examples are provided to support consistent and well-documented development.

Typical use cases for this skill include backend engineers and full-stack developers who are responsible for managing multiple API services behind a single gateway. It is suitable for teams working with Node.js, Python, Java, or Go frameworks, as well as those who rely on OpenAPI specifications for documentation and contract definition. The target users are developers who already have API designs and backend services in place and need structured assistance to assemble, document, and test an API gateway that integrates authentication, validation, and error handling in a standardized manner.