swagger

Name: swagger
Author: MikhailKayumov

Build the server and export the OpenAPI 3 spec to server/swagger.openapi3.json

by MikhailKayumov(0) 0 installs

Free

Free account. Installing gives you the manifest plus copy-paste snippets.

See reviews

About

Prompt file imported from MikhailKayumov/mesh-hub (.claude/commands/swagger.md). Copyright stays with the author.

Regenerate the OpenAPI spec.

Run cd server && npm run swagger:generate. This builds the server (nest build) and then writes server/swagger.openapi3.json from the live Swagger document.

After completion, summarise briefly:

Build success / failure
Modification time and size of server/swagger.openapi3.json
Best-effort list of new top-level paths since the previous version (use git diff --stat server/swagger.openapi3.json and git diff server/swagger.openapi3.json | head -200)

swagger.openapi3.json is the source of truth for the backend's exposed surface; the client dto.ts is hand-maintained against it. Suggest /update-dto if the user is about to update client types.

Use it

Copy one of these into your project. Installing also returns the manifest and these snippets.

Regenerate the OpenAPI spec.

Run `cd server && npm run swagger:generate`. This builds the server (`nest build`) and then writes `server/swagger.openapi3.json` from the live Swagger document.

After completion, summarise briefly:
- Build success / failure
- Modification time and size of `server/swagger.openapi3.json`
- Best-effort list of new top-level paths since the previous version (use `git diff --stat server/swagger.openapi3.json` and `git diff server/swagger.openapi3.json | head -200`)

`swagger.openapi3.json` is the source of truth for the backend's exposed surface; the client `dto.ts` is hand-maintained against it. Suggest `/update-dto` if the user is about to update client types.

Manifest

The prompt text and its fill-in variables. Copy it or fetch it by URL from your own code.

mikhailkayumov-mesh-hub-swagger-command.prompt.jsonjson

{
  "prompt": "Regenerate the OpenAPI spec.\n\nRun `cd server && npm run swagger:generate`. This builds the server (`nest build`) and then writes `server/swagger.openapi3.json` from the live Swagger document.\n\nAfter completion, summarise briefly:\n- Build success / failure\n- Modification time and size of `server/swagger.openapi3.json`\n- Best-effort list of new top-level paths since the previous version (use `git diff --stat server/swagger.openapi3.json` and `git diff server/swagger.openapi3.json | head -200`)\n\n`swagger.openapi3.json` is the source of truth for the backend's exposed surface; the client `dto.ts` is hand-maintained against it. Suggest `/update-dto` if the user is about to update client types.",
  "variables": [],
  "notes": "Build the server and export the OpenAPI 3 spec to server/swagger.openapi3.json Tools: Bash(cd server && npm run swagger:generate), Bash(git diff:*), Bash(ls:*).",
  "metadata": {
    "source": {
      "provider": "github-claude-commands",
      "repository": "https://github.com/MikhailKayumov/mesh-hub",
      "path": ".claude/commands/swagger.md",
      "ref": "f2aae89a565d038b44daf46a3c11d5b6915b22dd",
      "url": "https://github.com/MikhailKayumov/mesh-hub/blob/f2aae89a565d038b44daf46a3c11d5b6915b22dd/.claude/commands/swagger.md",
      "key": "MikhailKayumov/mesh-hub/.claude/commands/swagger.md"
    }
  }
}

Fetch it by URL: GET /api/v1/registry/mikhailkayumov-mesh-hub-swagger-command/manifest?version=1.0.0

About

Use it

Manifest

Reviews