Agent skill · software engineering · jeremylongshore
generating-rest-apis
Generate complete REST API implementations from OpenAPI specifications
Why this skill is useful
Adds executable scripts for generating complete REST API implementations, including route definitions, controllers, and OpenAPI specifications that are not commonly available in public documentation.
What it needs
Requires go, java, node, python installed locally. About 3k tokens when loaded. Last updated 2026-08-07. 2,604 stars on the source repository.
What this skill does
Generating REST APIs Overview Generate complete, production-ready REST API implementations from OpenAPI specifications, database schemas, or resource definitions. Scaffold CRUD endpoints with proper HTTP method semantics, content negotiation, pagination, filtering, and HATEOAS link generation across Express, FastAPI, Spring Boot, and Gin frameworks. Prerequisites Node.js 18+ with Express/Fastify, or Python 3.10+ with FastAPI/Flask, or Java 17+ with Spring Boot, or Go 1.21+ with Gin/Echo OpenAPI 3.0+ specification or database schema (SQL DDL, Prisma, Sequelize models) HTTP testing tool: curl, httpie, or Postman Database server (PostgreSQL, MySQL, MongoDB) accessible for ORM integration Package manager configured (npm, pip, Maven, or go modules) Instructions 1. Scan the project for existing OpenAPI specs, database models, or route definitions using Glob and Read to establish current API surface area. 2. Parse resource entities from the specification and generate model definitions with field types, validation constraints, and relationship mappings. 3. Create route files implementing all five standard REST operations per resource: GET /resources (list with pagination), GET /resources/:id, POST /resources, PUT /resources/:id, and DELETE /resources/:id. 4. Implement controller logic with input validation using JSON Schema or framework-native validators (Zod, Pydantic, Bean Validation). 5. Add query parameter support for filtering (?status=active), sorting (?sort=-createdat), field selection (?fields=id,name), and cursor-based or offset pagination. 6. Wire authentication middleware to protect mutation endpoints (POST, PUT, DELETE) while allowing read access per configuration. 7. Generate standardized error response envelopes with RFC 7807 Problem Details format for all 4xx/5xx responses. 8. Create integration tests covering happy paths, validation failures, 404s, and auth rejection for every endpoint. 9. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/generating-rest-apis