Agent skill

Insta Snapshot Review

by oxc-project in oxc-project/oxc

Reviews and accepts Insta snapshot changes in the Oxc repo from the command line, one reviewed snapshot at a time, instead of using the interactive UI.

MITAuto-check passedTesting & QA

Install Insta Snapshot Review

skills CLI
$ npx skills add oxc-project/oxc --skill insta-snapshots -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install oxc-project/oxc insta-snapshots --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/oxc-project/oxc.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/insta-snapshots .claude/skills/insta-snapshots && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
insta-snapshots
GitHub stars
23k
Token cost
~356 tokens
SKILL.md length
165 words
Files
1
Skills in repo
2
Repo updated
First seen
Licence
MIT

At a glance

Reviews and accepts Insta snapshot changes in the Oxc repo from the command line, one reviewed snapshot at a time, instead of using the interactive UI.

  • A snapshot test fails after an intentional change to output
  • Calls cargo
  • Reviewing pending Insta snapshots before accepting them
  • Updating only the snapshots related to your task in a large workspace

What it does

After expected output changes or a snapshot test fails, the agent reruns the affected test to produce pending snapshots, lists them with cargo insta pending-snapshots and compares each old .snap file with its new .snap.new output to judge whether the change matches intended behavior. Output that looks wrong is fixed in the implementation before anything is accepted.

Acceptance uses cargo insta accept on named snapshots, never the interactive review UI or hand-edited expected files, and it is scoped to the snapshots reviewed in the task rather than the whole workspace. Afterward the agent inspects the snapshot diff, reruns the test and leaves no pending .snap.new files. Updating snapshots does not by itself mean a commit. Linter diagnostic snapshots live under crates/oxc_linter/src/snapshots, while conformance .snap.md reports have their own update mechanism and are not Insta pending snapshots.

When your agent uses it

  • A snapshot test fails after an intentional change to output
  • Reviewing pending Insta snapshots before accepting them
  • Updating only the snapshots related to your task in a large workspace

Example prompts

  • “The linter test snapshots changed after my rule update, so review the pending ones and accept the correct ones.”
  • “Run the affected tests, compare the .snap and .snap.new files and tell me whether the new output is right.”
  • “Clean up so no .snap.new files remain pending after the snapshot update.”

Requirements

  • A Rust toolchain with cargo-insta installed
  • The Oxc repository

What it can do on your machine

Read from SKILL.md and the folder at commit 4a28c91. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • cargo

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Insta Snapshot Review loads about 356 tokens when it runs. Until then it costs about 32 tokens; SKILL.md has 165 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~32
When it runs · the whole SKILL.md, loaded when a task matches
~356

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from oxc-project/oxc at commit 4a28c91, republished under its MIT licence (© oxc-project). 165 words, ~356 tokens.

Download SKILL.mdSave it as .claude/skills/insta-snapshots/SKILL.md (or your agent's skills folder).
name
insta-snapshots
description
Review and update Oxc Insta snapshots non-interactively after expected output changes or snapshot test failures.

Insta snapshots

Run the affected test to generate pending snapshots. Use cargo insta pending-snapshots and read the old .snap and new .snap.new outputs to decide whether each change matches the intended behavior.

Use the CLI instead of the interactive cargo insta review UI or manually editing expected output:

bash
cargo insta pending-snapshots
cargo insta accept --snapshot <snapshot_name>

Scope acceptance to the reviewed snapshots from this task; check cargo insta accept --help if a name or package filter is ambiguous. Avoid workspace-wide acceptance or rejection when unrelated pending snapshots exist. Fix unexpected output in the implementation before accepting it.

After accepting, inspect the snapshot diff and rerun the affected test. Finish with the intended .snap updates and no task-generated .snap.new files left pending. Updating snapshots does not itself call for a commit.

Snapshots record expected output, including successful output in some crates. Linter diagnostic snapshots are under crates/oxc_linter/src/snapshots/; other crates have their own locations. Conformance .snap.md reports use a separate update mechanism; inspect the producing test harness rather than treating them as Insta pending snapshots.

© oxc-project, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .agents/skills/insta-snapshots of oxc-project/oxc.

Open the folder on GitHubat commit 4a28c91

Compare with similar skills

Insta Snapshot Review next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Insta Snapshot Review compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Insta Snapshot Review this skilloxc-project/oxc23k—~356Automated safety check: PassMIT
Debug Playwright Prowquay/quay2.8k—~2.2kAutomated safety check: PassApache-2.0
CI FixFastLED/FastLED7.5k—~897Automated safety check: PassMIT
Quay Prow Triagequay/quay2.8k—~2.9kAutomated safety check: PassApache-2.0
Test Guidelinesgetsentry/sentry-react-native1.8k—~1.3kAutomated safety check: PassMIT
gtest-parallel Test Runnerwebrtc-sdk/webrtc4461 repos~432Automated safety check: PassBSD-3-Clause

Similar skills

  • Deep-dive diagnosis of a Playwright test failure already isolated to one Quay Prow/OpenShift CI run: downloads its GCS artifacts (results.json, JUnit, build/pod logs, Jaeger traces), classifies real…

    2.8k GitHub stars~2.2k tokensUpdated yesterday
    Testing & QAAuto-check passed
  • CI Fix

    FastLED/FastLED

    Scan all CI builds and tests, find failures, fetch error logs, and fix the code.

    7.5k GitHub stars~897 tokensUpdated yesterday
    Testing & QAAuto-check passed
  • Diagnose any Quay Prow job failure end to end: prowjob.json - top-level build log - JUnit - resolved failing step - Playwright results.json when the failing step is Playwright, continuing through…

    2.8k GitHub stars~2.9k tokensUpdated yesterday
    Testing & QAAuto-check passed
  • Test Guidelines

    getsentry/sentry-react-native

    Official

    Enforce Sentry React Native SDK test conventions for naming, structure, mocking, and fixtures with Jest.

    1.8k GitHub stars~1.3k tokensUpdated yesterday
    Testing & QAAuto-check passed
  • Runs Google Test binaries in parallel with gtest-parallel to speed up single-threaded tests, repeat flaky ones and filter specific tests.

    446 GitHub starsUsed in 1 repo~432 tokens
    Testing & QAAuto-check passed
  • Ckeditor5 Testing

    TriliumNext/Trilium

    Testing CKEditor 5 plugins in the Trilium monorepo. An agent skill from TriliumNext/Trilium.

    38k GitHub stars~3.3k tokensUpdated yesterday
    Testing & QAAuto-check passed

More from oxc-project/oxc

  • Review guidance for the speed of Oxc linter rules written in Rust: narrow node-kind checks, cheap tests first, deferred diagnostics and the smallest possible iteration.

    23k GitHub stars~1.1k tokensUpdated yesterday
    Auto-check passed

Categories

Questions about Insta Snapshot Review

What does Insta Snapshot Review do?

Reviews and accepts Insta snapshot changes in the Oxc repo from the command line, one reviewed snapshot at a time, instead of using the interactive UI. new output to judge whether the change matches intended behavior. Output that looks wrong is fixed in the implementation before anything is accepted.

When should I use Insta Snapshot Review?

Insta Snapshot Review fits situations like: A snapshot test fails after an intentional change to output; reviewing pending Insta snapshots before accepting them; updating only the snapshots related to your task in a large workspace.

How do I install Insta Snapshot Review in Claude Code?

Run `npx skills add oxc-project/oxc --skill insta-snapshots -a claude-code`. Or copy the skill folder (.agents/skills/insta-snapshots in oxc-project/oxc) into .claude/skills/insta-snapshots in your project. Claude Code loads it when a task matches its description.

How do I install Insta Snapshot Review in Codex?

Run `npx skills add oxc-project/oxc --skill insta-snapshots -a codex`. Or copy the skill folder (.agents/skills/insta-snapshots in oxc-project/oxc) into .agents/skills/insta-snapshots in your project. Codex loads it when a task matches its description.

Can I use Insta Snapshot Review in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add oxc-project/oxc --skill insta-snapshots -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/insta-snapshots, .gemini/skills/insta-snapshots, .github/skills/insta-snapshots and .opencode/skills/insta-snapshots in your project.

What does Insta Snapshot Review need to run?

Going by SKILL.md and its folder, Insta Snapshot Review needs the command-line tools its instructions call (cargo). Our summary lists: A Rust toolchain with cargo-insta installed; The Oxc repository.

Does Insta Snapshot Review access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Insta Snapshot Review safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Insta Snapshot Review use?

Insta Snapshot Review is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Insta Snapshot Review use?

About 356 tokens (SKILL.md is roughly 1.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Insta Snapshot Review?

Skills that share tags, products or a category with Insta Snapshot Review: Debug Playwright Prow (quay/quay, 2.8k stars), CI Fix (FastLED/FastLED, 7.5k stars), Quay Prow Triage (quay/quay, 2.8k stars) and Test Guidelines (getsentry/sentry-react-native, 1.8k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Insta Snapshot Review?

oxc-project (a GitHub organization) maintains it in oxc-project/oxc, which has 22,966 GitHub stars. The repository holds 2 skills in this directory. The repository was last updated on October 8, 2026.

Source: oxc-project/oxc on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.