How do I install the Mock Generator skill?

Run npx skillmds@latest add redocly/mock-generator in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Mock Generator safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Mock Generator?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Mock Generator free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Mock Generator?

redocly (@redocly) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Mock Generator by redocly — Agent Skill

Name: Mock Generator
Author: redocly

File contents

The `mock` generator — its skill

This file is the DESIGN of your ejected mock generator (generators/mock/): to change the generator, edit this skill first, then make the code match it — a diff to generators/mock/ that has no covering sentence here is incomplete.

What it emits

A standalone MSW module: create<Name>() data factories, <op>Handler() / <op>ErrorHandler(status, body?) request handlers, and a handlers array.

Design decisions that must hold

Two data modes: mockData: static bakes deterministic samples from the schema (examples/defaults first); faker emits faker.* calls with a seed (mockSeed) so runs are reproducible.
Interpolated identifiers are gated (codeIdent): an operation name or method reaching a code position is validated, never trusted, even though the pipeline sanitizes upstream.
Handlers are opt-in overrides: <op>ErrorHandler is NOT in handlers.
The module references the sdk's TYPES only — never its runtime.

The stage files

render.ts assembles the module (factories, handlers, the handlers array); sample.ts bakes deterministic sample values from the schema, values.ts renders the data trees, and faker.ts emits the faker-mode expressions. index.ts is the entry.

Ejecting it

redocly eject-generator mock copies this generator's TypeScript source folder to generators/mock/, exactly as we wrote it, importing @redocly/client-generator, @redocly/client-generator/printers/typescript, and @redocly/openapi-core. Running a .ts generator uses Node's type stripping (Node 22.18, 23.6, or newer); newer built-in versions merge in per file with --update. Change the data strategy, the handler shape, or the factory surface, and regenerate.

The modify loop

Edit this skill: state the new behavior or decision.
Make generators/mock/ match it.
Run redocly generate-client and inspect the git diff of the generated output — generated files are never hand-edited.

Newer built-in versions merge in with redocly eject-generator mock --update.

---name: mock-generatordescription: Design of the ejected Redocly `mock` client generator. Read it, and update it, before changing generators/mock/.---# The `mock` generator — its skillThis file is the DESIGN of your ejected `mock` generator (`generators/mock/`):**to change the generator, edit this skill first, then make the code match it** — a diffto `generators/mock/` that has no covering sentence here is incomplete.## What it emitsA standalone MSW module: `create<Name>()` data factories, `<op>Handler()` /`<op>ErrorHandler(status, body?)` request handlers, and a `handlers` array.## Design decisions that must hold- **Two data modes:** `mockData: static` bakes deterministic samples from the schema (examples/defaults first); `faker` emits `faker.*` calls with a seed (`mockSeed`) so runs are reproducible.- **Interpolated identifiers are gated** (`codeIdent`): an operation name or method reaching a code position is validated, never trusted, even though the pipeline sanitizes upstream.- Handlers are opt-in overrides: `<op>ErrorHandler` is NOT in `handlers`.- The module references the sdk's TYPES only — never its runtime.## The stage files`render.ts` assembles the module (factories, handlers, the `handlers` array);`sample.ts` bakes deterministic sample values from the schema, `values.ts` renders thedata trees, and `faker.ts` emits the faker-mode expressions. `index.ts` is the entry.## Ejecting it`redocly eject-generator mock` copies this generator's TypeScript source folder to`generators/mock/`, exactly as we wrote it, importing `@redocly/client-generator`,`@redocly/client-generator/printers/typescript`, and `@redocly/openapi-core`. Running a`.ts` generator uses Node's type stripping (Node 22.18, 23.6, or newer); newer built-inversions merge in per file with `--update`. Change the data strategy, the handler shape,or the factory surface, and regenerate.## The modify loop1. Edit this skill: state the new behavior or decision.2. Make `generators/mock/` match it.3. Run `redocly generate-client` and inspect the `git diff` of the generated output — generated files are never hand-edited.Newer built-in versions merge in with `redocly eject-generator mock --update`.

Frequently asked questions

Mock Generator