polyviz

polyviz is a skill for Claude Code from cognitive-fab/polygraph. It costs 0 tokens per session (1,435 once invoked), scanned A, original, Apache-2.0.

A renderer that turns verification results into diagrams, such as state-machine graphs, invariant summaries, counterexamples, compatibility gates, and model cards. It uses stored artifact data and produces SVG files, with optional PNG output.

In plain words
What is it for?
Use it to render selected diagrams, render all supported diagram types, choose a light or dark theme, export PNGs, or hash SVG output to check that rendering is deterministic.
Why use it?
It makes verification results easier to inspect while keeping the picture tied to the data that was actually checked. Repeated renders produce identical files and do not call a model or the network.

Skill for Claude Code

Written for Claude Code: ${CLAUDE_PLUGIN_ROOT} variable.

Runs only inside its plugin — its command needs a path that Claude Code sets for a plugin’s own hooks and for nothing else. Install the plugin, not this.

Part of the polyviz plugin — 1 skill, 1 command, 1 agent shipped together

Good fit Use it to render selected diagrams, render all supported diagram types, choose a light or dark theme, export PNGs, or hash SVG output to check that rendering is deterministic.

Compare 6 skills from other repositories ↓
Install

Getting it into your agent

This one installs as part of its plugin. Adding the marketplace and installing the plugin brings it with everything else the plugin ships.

Claude Code
/plugin marketplace add cognitive-fab/polygraph
Claude Code
/plugin install polyviz

Made for: Claude Code.

Or install polyviz, the plugin that ships this one along with the rest of its 1 skill, 1 command, 1 agent.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for polyviz

README.md
[![agentmods](https://agentmods.dev/badge/skills/cognitive-fab/polygraph/polyviz/github.svg)](https://agentmods.dev/skills/cognitive-fab/polygraph/polyviz)
Your own site
<a href="https://agentmods.dev/skills/cognitive-fab/polygraph/polyviz"><img src="https://agentmods.dev/badge/skills/cognitive-fab/polygraph/polyviz/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for polyviz

Your own site · 80×15
<a href="https://agentmods.dev/skills/cognitive-fab/polygraph/polyviz"><img src="https://agentmods.dev/badge/skills/cognitive-fab/polygraph/polyviz.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 0 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,435 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00000 $0.01435
Opus 5.5 $0.00000 $0.00574
Sonnet 5.5 $0.00000 $0.00287
Haiku 4.5 $0.00000 $0.00144

Measured 1mo ago against content hash 76bd8b4c924b, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

polyviz scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 1mo ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

polyviz/skills/polyviz/SKILL.md · 88 lines

How it starts

The opening of the file, as written. The whole thing — 88 lines — stays where its author put it; the contents beside it link to each section on GitHub.

polyviz — visualize the verification, don't redraw it

polyviz is the VISUALIZATION side of the Polygraph method (Polygraph audits, polygen authors, polyrun executes, polyvers evolves, polynv elicits — polyviz draws). Every mark it emits traces to a field in a Polygraph artifact, so the picture cannot drift from the model that was actually checked. Rendering is a pure function artifacts → SVG: no Date.now(), no randomness, sorted keys — byte-identical on every run. An LLM may invoke polyviz; it never draws.

The CLI is ${CLAUDE_PLUGIN_ROOT}/bin/polyviz.mjs:

polyviz render --in <dir|polyviz.json> --diagram <all|state-machine|invariants|counterexample|compat-gate|model-card> \
               --out <dir> [--format svg[,png]] [--theme dark|light] [--tokens tokens.json] [--scale 2]
polyviz hash   --in <dir|polyviz.json> --diagram <...>     # sha256 per SVG, no files (determinism/CI check)
polyviz schema                                             # print the viz-model JSON Schema

Two ways to feed it

  1. A viz-model JSON (*.polyviz.json) — the stable contract (polyviz schema prints it). Pure viz-model → SVG: no user code executed, no optional deps needed for the SVG path. Best when you're authoring figures by hand or a tool already emitted a viz-model.

  2. A Polygraph/polyvers artifacts directory (--in <dir>) — adapters map the native artifacts to a viz-model:

    • contract.json + its SAM/next module → the machine graph. The contract has no edge list, so transitions are derived by a bounded, deterministic BFS that executes the module over its declared (action,data) domain. This runs the target module — only do it on a run you trust.
    • the invariants module (invariants.mjs) → the invariants panel.
    • a findings.json reporting a failure, resolved to its trace → the counterexample.
    • polyvers compat-report.json → the compat-gate. Drop a polyviz.annotations.json in the dir to supply the narrative the raw artifacts don't carry (titles, nicer invariant text, version-card labels, a highlighted state).

Read the full file on GitHub · 88 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 1mo ago Changed · +6 lines 76bd8b4c924b
  2. 1mo ago First seen · 82 lines · 0 tokens per session scan A cf4d60f34b32

Subscribe to this mod's changes

polyviz is a skill published in the GitHub repository cognitive-fab/polygraph (14 stars, last pushed 1mo ago), licensed Apache-2.0. It costs nothing until one of its globs matches a file; then it loads 1,435 tokens. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

ax-agent-optimize

This skill helps an LLM generate correct AxAgent tuning and evaluation code using @ax-llm/ax. Use when the user asks about agent.optimize(...), judgeOptions, eval datasets, optimization targets, saved optimizedProgram artifacts, or agent optimization guidance.

ax-llm/ax · 57 tokens

output-dev-eval-testing

Create offline evaluation tests for Output SDK workflows using @outputai/core/evals. Use when implementing test evaluators with verify(), creating dataset YAML files, building eval workflows, or running workflow tests via CLI.

growthxai/output · 47 tokens

output-eval-validate-judge

Validate LLM judges against human labels using TPR/TNR metrics and train/dev/test splits. Use after writing a judge prompt to verify it agrees with human judgment.

growthxai/output · 41 tokens

develop-ai-functions-example

Develop examples for AI SDK functions. Use when creating, running, or modifying examples under examples/ai-functions/src to validate provider support, demonstrate features, or create test fixtures.

vercel/ai · 40 tokens

output-dev-scenario-file

Create test scenario JSON files for Output SDK workflows. Use when creating test inputs, documenting expected behaviors, or setting up workflow testing.

growthxai/output · 32 tokens

capture-api-response-test-fixture

For provider response parsing tests, we aim at storing test fixtures with the true responses from the providers (unless they are too large in which case some cutting that does not change semantics is advised).

vercel/ai · 13 tokens