Developing Genkit JS skill for Claude Code: build Genkit apps in TypeScript

• Runs genkit --version and upgrades the CLI if older than 1.29.0

  If the CLI is missing or too old, the skill says to run npm install -g genkit-cli@^1.29.0.

  Runs code · Prerequisites check

• Reads docs with genkit docs:read, docs:search and docs:list

  Genkit had a major breaking API change, so Claude must look up docs, for example js/get-started.md, before writing code.

  Try: “Build a Genkit flow that summarizes a URL.”

  Runs code · Do not trust internal knowledge

• Reads common-errors.md before any fix

  On any Genkit error, Claude must first read the list of deprecated APIs (such as configureGenkit and response.text()) and their v1.x replacements. It forbids fixes based on assumptions.

  Read · Error troubleshooting protocol

• Six steps from agent-or-flow to error handling

  Use ai.defineAgent for conversational tasks, default to Google AI, read package.json for Next.js, Firebase or Express, follow best practices, run npx tsc --noEmit and verify with traces.

  Runs code · Development workflow

• Runs your app under the CLI to capture traces

  genkit start -- <your command> wraps your program and keeps running until Ctrl+C. genkit flow:run runs one flow, prints a Trace ID and exits.

  Runs code · genkit start and flow:run

• genkit trace:list and genkit trace:get

  Lets Claude check that tools were called and inspect model input and output; --format json gives clean JSON.

  Read · Trace commands

• Sets Genkit up in an existing project

  Creates an ai folder with genkit.ts, tools and flows folders and an index.ts, adds genkit-cli to devDependencies and a genkit:dev script. It says not to run the script.

  Runs code · Setup guide (references/setup.md)

• Reference files for newer Genkit features

  Ten agent guides, one A2UI guide for streaming UI surfaces, and middleware, dotprompt and observability guides. Agents need genkit 1.39.0 or newer.

  Read · Beta agents, A2UI and middleware guides

Watch out for

• It can install packages and create files

  The prerequisites install genkit-cli globally if it is missing or old, and the setup guide adds a dev dependency, a package.json script and new files. Review each command and the diff. github.com

• It runs your app under the Genkit CLI

  genkit start and genkit flow:run run your own program, so any model or API calls in it happen as normal, and the CLI captures traces of model input and output. github.com

• The Genkit CLI shows an analytics notice on first run

  SKILL.md mentions a first-run analytics notice and tells agents to add --non-interactive to skip prompts. Read the notice yourself before you pass that flag. github.com

Security advisories