gomtm-openapi-gen
Installation
SKILL.md
gomtm OpenAPI Generation
Overview
gomtm-openapi-gen owns gomtm OpenAPI artifact refresh work. The workflow is intentionally kept as agent-run shell scripts under this skill so the public gomtm CLI remains focused on runtime, deploy, database, install, and operational commands.
The canonical committed OpenAPI artifact is:
pkg/clicmd/openapi.json
That file is embedded by pkg/clicmd to register OpenAPI-driven CLI commands. Regenerate it when route schemas, route options, request/response models, or Fuego OpenAPI metadata change.
When to Use
- A gomtm route, request model, response model, or
routeoptsCLI extension changed. pkg/clicmd/openapi.jsonneeds to be refreshed before committing API/CLI changes.- An external consumer explicitly needs a temporary Go REST client generated from the current spec.
- A review asks whether embedded OpenAPI CLI metadata is current.