skills.rest
lety-ai
lety-aiOFFICIAL
Explore all skills by this author →
GitHub

gateway-controller

Scaffold NestJS API gateway features translating HTTP REST endpoints into gRPC service calls.

Updated Apr 6, 2026
Search Tags:#permissions#scaffold#swagger#nestjs#grpc#api-gateway#proto3
One-click install
npx skills add https://github.com/lety-ai/lety-skill-hub --skill gateway-controller
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gateway-controller
Source: https://github.com/lety-ai/lety-skill-hub/tree/main/plugins/gateway-controller/skills/gateway-controller
Command: npx skills add https://github.com/lety-ai/lety-skill-hub --skill gateway-controller

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates the creation of API Gateway features that connect HTTP REST endpoints to downstream gRPC microservices, removing boilerplate and ensuring consistent, production-ready integrations across the gateway.

Core Features & Use Cases

  • Proto & Interface Generation: Creates proto3 interface files and service definitions following official proto3 conventions and pagination/common message patterns.
  • NestJS Gateway Boilerplate: Generates controller, service, and module files wired with ClientsModule.registerAsync, grpc client injection, lastValueFrom calls, metadata enrichment, Swagger decorators, and permission guards.
  • Integration & Compliance: Enforces best practices such as snake_case proto fields, optional nullable fields, ParseUUIDPipe for UUID params, and operationId uniqueness to avoid runtime integration issues.
  • Use Case: When adding a new domain endpoint to the API gateway, use this Skill to produce the proto contracts and gateway layer scaffolding ready for codegen and registration in the gateway routing.

Quick Start

Scaffold a new tenant Invoice gateway feature that exposes REST endpoints and forwards requests to the tenant Invoice gRPC service.

Frequently Asked Questions about gateway-controller

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

FAQPage Schema
How do I scaffold a NestJS API gateway that translates REST endpoints to gRPC calls?▼

To scaffold a NestJS API gateway translating REST to gRPC, generate controller, service, and module files wired with ClientsModule.registerAsync. This setup injects gRPC clients, enforces lastValueFrom for service calls, and enriches metadata for downstream microservices.

What proto3 conventions are enforced when generating proto interface files for an API gateway?▼

Proto3 conventions enforced for API gateway proto files include using snake_case for fields, defining optional nullable fields, and following pagination/common message patterns. This ensures consistent service definitions and prevents runtime integration issues.

Can I use Fastify controllers with NestJS ClientsModule to connect to gRPC microservices?▼

Yes, you can use Fastify controllers with NestJS ClientsModule to connect to gRPC microservices. The generated gateway scaffolding injects gRPC clients into Fastify controllers, translating HTTP REST endpoints into downstream gRPC service calls with metadata enrichment.

How do Swagger decorators and permission checks integrate into a NestJS gRPC gateway?▼

Swagger decorators and permission checks integrate directly into the NestJS gateway controller layer. The scaffolding applies Swagger documentation decorators alongside permission guards on REST endpoints, ensuring API compliance before forwarding HTTP requests to gRPC services.

Does the API gateway scaffolding enforce UUID validation and operationId uniqueness for gRPC integrations?▼

The API gateway scaffolding enforces UUID validation using ParseUUIDPipe for UUID parameters and ensures operationId uniqueness across endpoints. These compliance measures prevent routing conflicts and runtime integration issues during gRPC service communication.

Related Skills

Explore More Software Engineering Skills→
juburrjuburr
1

go-protobuf

Generate Go protobuf code from proto3 schemas for gRPC services.

Community
Advanced
copilot-ldcopilot-ld
1

libcodegen

Generate JavaScript message classes, service stubs, and type definitions from .proto files.

Official
Advanced
WbunkerWbunker

grpc-expert

Provides guidance on designing, testing, and deploying gRPC microservices with Kubernetes and Docker.

Community
Advanced
AratKruglikAratKruglik
9

nest-advanced

Configure GraphQL, WebSocket, and microservice modules in NestJS projects.

Community
Advanced