generate-api-client SKILL.md skillA

generate-api-client from nerds-odd-e/doughnut is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add nerds-odd-e/doughnut/generate-api-client@git:20260930.c3a7e2f

Pins git:20260930.c3a7e2f in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
nerds-odd-e/doughnut
Path
.agents/skills/generate-api-client/SKILL.md
Versions recorded
4
Latest version
git:20260930.c3a7e2f, committed Sep 30, 2026
First version recorded
Jul 26, 2026
Size
3,249 bytes
Repository stars
50
License
MIT

Regenerate the frontend TypeScript API client from backend OpenAPI spec. Use after changing backend controller signatures or related data types. Triggers on: generateTypeScript, API regeneration, controller signature changed, OpenAPI lint failure, generated API code.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

<objective>
Regenerate the frontend TypeScript API client from the backend OpenAPI spec and
fix any broken frontend usage.

Purpose: Keep `packages/generated/donut-backend-api` in sync with Java
controllers — never hand-edit generated output.

Output: Regenerated client + green frontend tests + summary ending with
`## API CLIENT GENERATED`.
</objective>

<context>
The frontend API client at `packages/generated/donut-backend-api` is
auto-generated from the backend OpenAPI spec.

**Never edit generated code directly.** This includes whitespace-only cleanup in
`sdk.gen.ts`, `types.gen.ts`, and `open_api_docs.yaml`; if generated output
changes, accept it or fix the generator path.

**Git does not use the Nix prefix.** All other repo tooling does:
`CURSOR_DEV=true nix develop -c …`

Do not run raw `git diff --check` as a generated-client cleanup gate. Use
`scripts/check_diff_whitespace.sh`, which excludes generated API artifacts from
manual whitespace fixes.

**Regenerate when:**
- A backend controller signature changed
- A backend data type used by any controller signature changed
- `pnpm openapi:lint` or `pnpm format:all` fails with OpenAPI validation errors
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add nerds-odd-e/doughnut/generate-api-client@sha256:2b91b6635e6d57fb

The line at the top of this page pins the label git:20260930.c3a7e2f, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_jt36tjvjs4k5dvbw.svg)](https://markdownregistry.com/a/art_jt36tjvjs4k5dvbw)

3 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 4 versions of this file, between Jul 26, 2026 and Sep 30, 2026, about one every 22 days.

versioncommittedcommitsizeaudit
git:20260930.c3a7e2f latest2026-09-30 c3a7e2f 3,249 BA view · diff
git:20260916.b3341042026-09-16 b334104 3,016 BA view · diff
git:20260826.f88eb092026-08-26 f88eb09 3,010 BA view · diff
git:20260726.72e37c12026-07-26 72e37c1 3,016 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (3249 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

nerds-odd-e/doughnut · 50 stars · license MIT · pushed 2026-11-05 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_jt36tjvjs4k5dvbw
GET https://markdownregistry.com/api/v1/resolve?ref=nerds-odd-e/doughnut/generate-api-client
GET https://markdownregistry.com/api/v1/blob/2b91b6635e6d57fb24fe5ae2081ce16dbcff6c846f994086b7733ed243321493

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from nerds-odd-e/doughnut

backend-code SKILL.md skill
nerds-odd-e/doughnut · .agents/skills/backend-code/SKILL.md · Backend Java production code, Spring Boot controllers/services/repositories, controller return values, imports, schema…
git:20260928.32163ae · audit A · 50 stars
backend-testing SKILL.md skill
nerds-odd-e/doughnut · .agents/skills/backend-testing/SKILL.md · Backend Java tests, controller-level stable-boundary tests, JUnit, @Nested, MakeMe builders, @Transactional…
git:20261003.8204a88 · audit A · 50 stars
backend SKILL.md skill
nerds-odd-e/doughnut · .agents/skills/backend/SKILL.md · Backend Java — Spring Boot controllers/services, JUnit controller tests, MakeMe. Read this first for any backend work…
git:20260918.3a97b0e · audit A · 50 stars
cli SKILL.md skill
nerds-odd-e/doughnut · .agents/skills/cli/SKILL.md · related to donut CLI. Use when working on donut-cli.
git:20260916.b334104 · audit A · 50 stars
cloud-vm-setup SKILL.md skill
nerds-odd-e/doughnut · .agents/skills/cloud-vm-setup/SKILL.md · Set up and run the Donut dev environment on Cursor Cloud VM (no Nix). Use when working on Cloud VM, running tests on…
git:20261101.6bb5c5b · audit B · 50 stars
database-erd SKILL.md skill
nerds-odd-e/doughnut · .agents/skills/database-erd/SKILL.md · Regenerate docs/database-erd.md from MySQL information_schema (Mermaid ERD: foreign keys and key columns). Use after…
git:20260826.0b913a6 · audit A · 50 stars
db-migration SKILL.md skill
nerds-odd-e/doughnut · .agents/skills/db-migration/SKILL.md · Database migration, Flyway, SQL migrations, schema changes, database versioning, migration files, squashing historical…
git:20260928.428ed03 · audit A · 50 stars
dough-adr-awareness SKILL.md skill
nerds-odd-e/doughnut · .agents/skills/dough-adr-awareness/SKILL.md · Use and cite this project's current Accepted Architectural Decision Records for architecture-shaped work, follow…
git:20260909.3784459 · audit A · 50 stars
dough-bug-fixing SKILL.md skill
nerds-odd-e/doughnut · .agents/skills/dough-bug-fixing/SKILL.md · Resolves a reported discrepancy, defect, or regression by gathering expected versus actual behavior and passing the…
git:20261105.61c0a9a · audit A · 50 stars
dough-execute-plan SKILL.md skill
nerds-odd-e/doughnut · .agents/skills/dough-execute-plan/SKILL.md · Executes one selected story or bounded retrospective correction through an executable plan, or one authorized planless…
git:20261031.b173027 · audit A · 50 stars
dough-execution-retrospective SKILL.md skill
nerds-odd-e/doughnut · .agents/skills/dough-execution-retrospective/SKILL.md · Reviews planned, completed planless quick, or quick-to-planned execution against original intent, aggregate commits…
git:20261101.f700975 · audit A · 50 stars
dough-land SKILL.md skill
nerds-odd-e/doughnut · .agents/skills/dough-land/SKILL.md · Dough Land lands everything in one reviewed checkout on the authorized remote trunk: commits all of its changes…
git:20261105.61c0a9a · audit A · 50 stars

Every file in nerds-odd-e/doughnut

Browse by kind, by grade A, or by owner.