openapi-doc-from-controller

Installation
SKILL.md

OpenAPI doc from controller method

This skill defines how to create or update exactly one OpenAPI path item in the project docs/ folder, derived from a single controller method in the codebase.

Input parameters

Supply these as ordered lines (one per line, no prefixes):

  1. Controller method name (e.g. getAssociations) — the real method name that implements the endpoint (no __ prefix). Use as ${method}.
  2. Target YAML path under docs/ (e.g. associations.yaml). Use as ${file}.
  3. (Optional) Repo-relative path to the controller file (e.g. src/controllers/associations.controller.ts) for context. Source lives under src/; use .ts extension.

Example:

getAssociations
associations.yaml
src/controllers/associations.controller.ts
Installs
4
First Seen
Mar 17, 2026
openapi-doc-from-controller — marco-meini/cursor