Agent skill

Update Test Snapshots

by oocx in oocx/tfplan2md

Regenerate test snapshot files after intentional markdown output changes.

MITAuto-check passedDevOps & Cloud

Install Update Test Snapshots

skills CLI
$ npx skills add oocx/tfplan2md --skill update-test-snapshots -a claude-code

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

GitHub CLI
$ gh skill install oocx/tfplan2md update-test-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/oocx/tfplan2md.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/update-test-snapshots .claude/skills/update-test-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
update-test-snapshots
GitHub stars
174
Token cost
~734 tokens
SKILL.md length
244 words
Files
1
Skills in repo
28
Repo updated
First seen
Licence
MIT

At a glance

Regenerate test snapshot files after intentional markdown output changes.

  • Works in 5 steps: Deletes all existing snapshot files in… → Runs snapshot tests (which will fail but… → Counts generated snapshots to verify… → …
  • Tasks that involve Markdown
  • SKILL.md covers Purpose, Hard Rules, Actions and Expected Output, plus 3 more sections
  • Calls git

What it does

Update Test Snapshots is an agent skill from oocx/tfplan2md. Regenerate test snapshot files after intentional markdown output changes. Use after modifying templates or rendering logic.

Its SKILL.md is about 730 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts. Compatibility notes: Requires .NET SDK and access to the test project.

It sits in DevOps & Cloud, covering Markdown. The repository describes itself as: Convert terraform plans (json) into human readable markdown for easier review of changes in pull requests. The licence is MIT.

When your agent uses it

  • Tasks that involve Markdown

Example prompts

  • “/update-test-snapshots”

Requirements

  • Compatibility (from SKILL.md): Requires .NET SDK and access to the test project.

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Deletes all existing snapshot files in src/tests/Oocx.TfPlan2Md.Tests/TestData/Snapshots/
  2. Runs snapshot tests (which will fail but create new snapshots)
  3. Counts generated snapshots to verify success
  4. Runs snapshot tests again to verify they pass with new baselines
  5. Reports success with instructions to review changes

What it can do on your machine

Read from SKILL.md and the folder at commit 88d5240. 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:

    • git

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

  • Network

    No URLs in SKILL.md. Its commands use git, which can reach the network depending on how they are called.

    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.

  • Compatibility

    Requires .NET SDK and access to the test project.

    From compatibility in the SKILL.md frontmatter.

Context cost

Update Test Snapshots loads about 734 tokens when it runs. Until then it costs about 36 tokens; SKILL.md has 244 words of instructions outside code blocks.

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

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 oocx/tfplan2md at commit 88d5240, republished under its MIT licence (© oocx). 244 words, ~734 tokens.

Download SKILL.mdSave it as .claude/skills/update-test-snapshots/SKILL.md (or your agent's skills folder).
name
update-test-snapshots
description
Regenerate test snapshot files after intentional markdown output changes. Use after modifying templates or rendering logic.
compatibility
Requires .NET SDK and access to the test project.

Update Test Snapshots

Purpose

Regenerate all test snapshot (golden file) baselines when intentional changes are made to markdown output. This updates the expected outputs that snapshot tests compare against.

Hard Rules

Must
  • Use the stable wrapper script: scripts/update-test-snapshots.sh
  • Script will handle deleting old snapshots, running tests, and verification automatically
  • Always allow this script — it only modifies test snapshot files, no production code
  • Review the git diff of snapshot changes before committing
Must Not
  • Manually copy files to update snapshots
  • Update snapshots without understanding why they changed
  • Run without first verifying the new output is correct
  • Skip reviewing snapshot diffs before committing

Actions

Regenerate All Snapshots
bash
scripts/update-test-snapshots.sh

This single command:

  1. Deletes all existing snapshot files in src/tests/Oocx.TfPlan2Md.Tests/TestData/Snapshots/
  2. Runs snapshot tests (which will fail but create new snapshots)
  3. Counts generated snapshots to verify success
  4. Runs snapshot tests again to verify they pass with new baselines
  5. Reports success with instructions to review changes

Expected Output

[INFO] Deleting existing snapshot files...
[INFO] ✓ Deleted 6 snapshot files
[INFO] Running snapshot tests to regenerate files...
[INFO] (Tests will fail on first run, but will create new snapshots)
[INFO] ✓ Generated 6 new snapshot files
[INFO] Running snapshot tests again to verify...
[INFO] ✅ All snapshot tests pass!

Snapshots updated successfully. Review changes with:
  git diff src/tests/Oocx.TfPlan2Md.Tests/TestData/Snapshots

When to Use

  • After intentionally modifying markdown rendering logic (C# renderers)
  • After changing markdown rendering logic
  • After updating formatting rules (value escaping, table formatting, etc.)
  • After adding new snapshot tests
  • When snapshot tests fail due to expected changes

What Gets Updated

Snapshot files in src/tests/Oocx.TfPlan2Md.Tests/TestData/Snapshots/:

  • comprehensive-demo.md - Full comprehensive demo output
  • summary-template.md - Summary template output
  • breaking-plan.md - Edge cases with escaping
  • role-assignments.md - Role assignment rendering
  • firewall-rules.md - Firewall rule semantic diff
  • multi-module.md - Multi-module plan output

After Running

Always review the changes:

bash
git diff src/tests/Oocx.TfPlan2Md.Tests/TestData/Snapshots/

Verify the changes match your expectations, then stage and commit:

bash
git add src/tests/Oocx.TfPlan2Md.Tests/TestData/Snapshots/
git commit -m "test: update snapshots after [describe change]"

© oocx, 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/update-test-snapshots of oocx/tfplan2md.

Open the folder on GitHubat commit 88d5240

Compare with similar skills

Update Test Snapshots 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.

Update Test Snapshots compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Update Test Snapshots this skilloocx/tfplan2md174—~734Automated safety check: PassMIT
Docs Learn Site Structurenetdata/netdata81k—~1.7kAutomated safety check: PassGPL-3.0
Save Researchmeain/dotfiles285—~1.6kAutomated safety check: PassMIT
Triageflowershow/flowershow1.1k—~1.9kAutomated safety check: PassAGPL-3.0
Okfscaccogatto/okf-skills408—~2.1kAutomated safety check: NotesMIT
Take Doc Screenshotspgplex/pgconsole155—~841Automated safety check: PassApache-2.0

Similar skills

  • Change, review or troubleshoot Learn publication, docs/.map mapping, page URLs, redirects, sidebars, MDX and ingest/CI behavior.

    81k GitHub stars~1.7k tokensUpdated today
    DevOps & CloudAuto-check passed
  • Save Research

    meain/dotfiles

    Summarize and save research findings from the current conversation into a well-structured markdown document.

    285 GitHub stars~1.6k tokensUpdated 1 mo ago
    DevOps & CloudAuto-check passed
  • Triage

    flowershow/flowershow

    Automatically triage a newly opened GitHub issue — categorise it, verify the claim, and apply the right category and state so a maintainer or agent can pick it up.

    1.1k GitHub stars~1.9k tokensUpdated 2 days ago
    DevOps & CloudAuto-check passed
  • Okf

    scaccogatto/okf-skills

    Author, maintain, and consume Open Knowledge Format (OKF) knowledge bundles — portable markdown + YAML frontmatter that both humans and agents read.

    408 GitHub stars~2.1k tokensUpdated 10 days ago
    DevOps & CloudAuto-check: notes
  • Take Doc Screenshots

    pgplex/pgconsole

    Take screenshots of the running pgconsole app for documentation.

    155 GitHub stars~841 tokensUpdated 1 mo ago
    DatabasesAuto-check passed
  • Ask The Docs

    supabase/supabase

    Official

    Answer questions about the Supabase docs app (apps/docs) using documented architecture, build pipeline, and review-pattern notes, and apply feature-design principles (codebase reuse, coding…

    111k GitHub stars~2.4k tokensUpdated today
    Documents & OfficeAuto-check passed

More from oocx/tfplan2md

All 28 skills in this repo
  • Create Agent Skill

    oocx/tfplan2md

    Create a new Agent Skill following project standards and templates.

    174 GitHub stars~1.5k tokensUpdated yesterday
    Auto-check passed
  • Detect and analyze edge crossings and overlaps in SVG workflow diagrams using geometric intersection algorithms and visual analysis.

    174 GitHub stars~4.3k tokensUpdated yesterday
    Auto-check passed
  • Generate PNG screenshots for release notes using the repository's HtmlRenderer and ScreenshotGenerator tools.

    174 GitHub stars~3.7k tokensUpdated yesterday
    Auto-check passed
  • Git Rebase Main

    oocx/tfplan2md

    Safely rebase the current feature branch on top of the latest origin/main.

    174 GitHub stars~456 tokensUpdated yesterday
    Auto-check passed
  • Next Issue Number

    oocx/tfplan2md

    Determine the next available issue number across all change types (feature, fix, workflow, website) by checking both local docs and remote branches, then reserve it by pushing an empty branch.

    174 GitHub stars~1.5k tokensUpdated yesterday
    Auto-check passed
  • Run Uat

    oocx/tfplan2md

    Run User Acceptance Testing by creating a PR with rendered markdown on GitHub or Azure DevOps.

    174 GitHub stars~1.2k tokensUpdated yesterday
    Auto-check passed

Questions about Update Test Snapshots

What does Update Test Snapshots do?

Regenerate test snapshot files after intentional markdown output changes. Update Test Snapshots is an agent skill from oocx/tfplan2md. Regenerate test snapshot files after intentional markdown output changes.

When should I use Update Test Snapshots?

Update Test Snapshots fits situations like: tasks that involve Markdown.

How do I install Update Test Snapshots in Claude Code?

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

How do I install Update Test Snapshots in Codex?

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

Can I use Update Test Snapshots 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 oocx/tfplan2md --skill update-test-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/update-test-snapshots, .gemini/skills/update-test-snapshots, .github/skills/update-test-snapshots and .opencode/skills/update-test-snapshots in your project.

What does Update Test Snapshots need to run?

Going by SKILL.md and its folder, Update Test Snapshots needs the command-line tools its instructions call (git). Compatibility (from SKILL.md): Requires .NET SDK and access to the test project..

Does Update Test Snapshots access the network?

SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Update Test Snapshots 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 Update Test Snapshots use?

Update Test Snapshots 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 Update Test Snapshots use?

About 734 tokens (SKILL.md is roughly 2.9k 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 Update Test Snapshots?

Skills that share tags, products or a category with Update Test Snapshots: Docs Learn Site Structure (netdata/netdata, 81k stars), Save Research (meain/dotfiles, 285 stars), Triage (flowershow/flowershow, 1.1k stars) and Okf (scaccogatto/okf-skills, 408 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Update Test Snapshots?

oocx (a GitHub user) maintains it in oocx/tfplan2md, which has 174 GitHub stars. The repository holds 28 skills in this directory. The repository was last updated on October 7, 2026.

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