codegen

A code-generation workflow for creating TypeScript models, React Query hooks, and mock request handlers from OpenAPI files. OpenAPI files describe an application's HTTP API.

In plain words
What is it for?
Use it after changing one of the API specifications, when generated hooks are missing, or when updating mock scenarios. Run `task generate` and commit the generated output.
Why use it?
It keeps generated client code aligned with the API definitions and prevents manually edited generated files from becoming out of date.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/nvidia/nvcf/codegen
Any agent
npx skills add NVIDIA/nvcf --skill codegen
Clone the repo
git clone --depth 1 https://github.com/NVIDIA/nvcf

Made for: Claude Code, Codex.

Per session 59 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 746 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00059 $0.00746
Opus 5 $0.00030 $0.00373
Sonnet 5 $0.00012 $0.00149
Haiku 4.5 $0.00006 $0.00075

Measured 2d ago against content hash e8f57dad7fad, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

codegen scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

src/uis/nvcf-ui/.claude/skills/codegen/SKILL.md · 52 lines

How it starts

The opening of the file, as written. The whole thing — 52 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Code Generation Pipeline

task generate runs Orval, which reads the three OpenAPI specs in spec/ directly and generates React Query hooks, TypeScript models, and MSW handler factories into ui/src/generated/. It then adds Apache license headers to the output. There is no bundling step (no Redocly, no openapi.yaml).

Specs:

  • spec/control-plane-openapi.yaml — the UI shim/BFF API
  • spec/nvcf-openapi.yaml — NVCF Cloud Functions (v2) API
  • spec/sis-openapi.yaml — cluster API

Gotchas

  • Edit the specs in spec/ — never edit anything in ui/src/generated/ (regenerated output).
  • ui/src/generated/ is committed and enforced by the Codegen Check CI job: if you change a spec, run task generate and commit the regenerated output, or CI fails on the diff.
  • Orval config is in ui/orval.config.ts (one shared output block spread across all three specs). Customize generation there, not in the generated files.
  • Generated hook names follow Orval's convention: useGetFunctions, useGetFunctionsSuspense, getGetFunctionsQueryOptions. The double "Get" is expected — don't rename them.

What Gets Generated

  • React Query hooksuseGetFunctions, useGetFunctionsSuspense, etc. (suspense variants are generated globally).
  • Query options factoriesgetGetFunctionsQueryOptions for use in route loaders.
  • TypeScript models — plain interface/type files in ui/src/generated/model/ (no runtime validation). Zod generation is intentionally off; re-add it as a separate client: "zod" Orval target if runtime validation is ever needed.
  • MSW handler factories — per-endpoint mock handlers plus per-response mock generators (getGetFunctionVersionResponseMock, etc.).

Mocks and Scenarios

The default mock baseline is a seeded in-memory store (ui/src/mocks/store/), not the raw generated handlers. The store builds a stable dataset once (keyed by account ncaId) using the generated response-mock generators, so list and detail views stay consistent and their IDs line up.

Read the full file on GitHub · 52 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 52 lines · 59 tokens per session scan A e8f57dad7fad

Subscribe to this mod's changes

codegen is a skill published in the GitHub repository NVIDIA/nvcf (202 stars, last pushed 2d ago), licensed Apache-2.0. It adds 59 tokens to every session and 746 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

vmware-privateai

Use this skill whenever the user needs the GPU / AI-infrastructure layer of VMware Private AI Foundation with NVIDIA (PAIF-N) on vSphere 9.x / VCF 9.1: inventory GPU hosts and physical GPU devices, see which VMs consume a vGPU and the profile each holds, read real-time GPU utilization, list the vGPU and DirectPath…

vmware-skills/VMware-PrivateAI · 237 tokens

kubernetes-mesh-provisioner

Kubernetes Mesh Provisioner atomic skill. Stands up an RKE2 cluster (server + agents) with Cilium CNI and the NVIDIA GPU device plugin, the Kubernetes parallel of swarm-mesh-provisioner. Idempotent — re-runnable.

Knuckles-Team/container-manager-mcp · 60 tokens

accelerated-computing-cudf

Official NVIDIA-authored guidance for NVIDIA cuDF GPU DataFrames, pandas acceleration, dask-cuDF, ETL, joins, groupby, CSV/Parquet I/O, nullable semantics, and multi-GPU DataFrame workloads.

PracticalSwan/agent-skills · 56 tokens

llm-torch-profiler-analysis

Unified LLM torch-profiler triage skill for sglang, vllm, TensorRT-LLM, and TokenSpeed. Use it to inspect an existing trace.json(.gz) or profile directory, or to drive live profiling against a running server when supported and return one three-table report with kernel, overlap-opportunity, and fuse-pattern tables.

sgl-project/sglang · 84 tokens

cookbook-review-pr

Review a pull request against the SGLang Cookbook (docs/, Mintlify) contribution checklist — the config-driven format (per-model config + benchmarks JSX consumed by the shared deployment.jsx / playground.jsx engines). Run with /cookbook-review-pr .

sgl-project/sglang · 60 tokens

speculative-naming

Naming conventions for SGLang speculative decoding identifiers. Use when adding, renaming, or reviewing identifiers in speculative decoding code — anything under python/sglang/srt/speculative/, related attention backends, scheduler accumulators, IPC fields, observability metrics, or CLI flags.

sgl-project/sglang · 63 tokens