Cmd Golden Tests

Set up or extend golden/snapshot tests for a project. Covers fixture design, Makefile targets, snapshot storage, diff workflow, and update protocol.

9 starsTesting & QA Plugin marketplace

Install

Claude Code plugin
/plugin marketplace add Olshansk/agent-skills

The repo is a Claude Code plugin marketplace. Run /plugin afterwards to pick the plugin that includes this skill.

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add Olshansk/agent-skills --skill cmd-golden-tests
Manual install
git clone --depth 1 https://github.com/Olshansk/agent-skills.git /tmp/agent-skills
mkdir -p ~/.claude/skills
cp -r /tmp/agent-skills/skills/cmd-golden-tests ~/.claude/skills/cmd-golden-tests

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Golden Tests

Golden (snapshot) tests capture the exact output of a pipeline or subsystem as a reference file, then fail any run that deviates from it. They are the highest-fidelity regression check: if anything in the pipeline changes — parsing, mapping, migration, export — the diff tells you exactly what shifted.

## Reference Implementation

The paradigm for this skill comes from `boredm/gint_to_boredm`. Read it before adapting anything:

- Makefile targets: `makefiles/golden.mk`
- Snapshot scripts: `scripts/golden_thompson.py`
- Fixtures: `server/tests/fixtures/`
- Workflow golden: `golden.md`

---

## The Five Setup Questions

Answer these before writing any code or Makefile targets.

### 1. What is the fixture / on-device schema?

The input data the pipeline runs against. Must be:
- **Checked in** to the repo (or clearly documented how to obtain it)
- **Small enough** to run in CI without special infra
- **Representative** of real edge cases, not just happy-path data

In boredm: real `.gpj` files in `thompson_sample/` (binary, not committed to the main repo — seeded via `make seed-thompson`).

### 2. What is the API under test?

How the system is invoked in the golden test. Three patterns:

| Pattern | Use when | Example |
|---------|----------|---------|
| **Direct function call** | Testing a pure transformation | `schema_grouping.build_grouping_outputs(schemas)` |
Read the full skill on GitHub

Details

Skill name
cmd-golden-tests
Path
skills/cmd-golden-tests/SKILL.md
License
MIT
Repo updated
18 November 2026

FAQ

What does the Cmd Golden Tests skill do?

Set up or extend golden/snapshot tests for a project. Covers fixture design, Makefile targets, snapshot storage, diff workflow, and update protocol.

How do I install the Cmd Golden Tests skill?

Claude Code plugin: /plugin marketplace add Olshansk/agent-skills. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Cmd Golden Tests popular?

It lives in Olshansk/agent-skills, which has 9 GitHub stars and 0 forks.

Related skills

Browse the most popular Claude skills, all testing & qa skills, or write your own with the skills generator.