How do I install the Visualize skill?

Run npx skillmds@latest add scaccogatto/visualize 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 Visualize 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 Visualize?

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 Visualize free to use?

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

Who published Visualize?

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

Visualize by scaccogatto — Agent Skill

Name: Visualize
Author: scaccogatto

Visualize

Render an Open Knowledge Format (OKF) bundle as a single self-contained, interactive HTML graph (viz.html) — concepts as nodes coloured by type and sized by body length, markdown links and bundle-internal `sources` as edges, a wiki-style detail panel with rendered markdown, v0.2 trust/lifecycle/provenance metadata, and "Links to" / "Cited by" backlinks, layout switching, per-type filter and search. Use when asked to visualize, graph, preview, or explore an OKF bundle.

scaccogatto Updated Sep 22, 2026

File contents

Visualize an OKF bundle

Generate a self-contained HTML graph of the target bundle. The bundle directory is required, so pass .okf explicitly when no path is given. No backend, no install, no bundle content leaves the page. The viewer does need network access: cytoscape, marked and dompurify load from cdn.jsdelivr.net.

uv run "${CLAUDE_SKILL_DIR}/scripts/okf_visualize.py" $ARGUMENTS

If uv is unavailable:

python3 -m pip install --quiet pyyaml && \
python3 "${CLAUDE_SKILL_DIR}/scripts/okf_visualize.py" $ARGUMENTS

The detail panel shows each concept's type, description, tags, status, generated, verified, stale_after, sources (with their credibility signals, a usage_count alongside the usage_window that frames it), and rendered body; a sources entry pointing at another concept in the bundle also becomes a graph edge. A v0.1 timestamp is read as generated.at, so legacy bundles still render fully.

Two badges are derived, not read: the §5.3 trust tier (unverified / machine-confirmed / human-reviewed, keyed off the human: prefix in verified[].by) and staleness (today >= stale_after). They are advisory signals — when reporting on a bundle, say which tier a concept is in rather than treating any of them as a gate.

Flag	Effect
`-o <path>`	Output file (default `<bundle>/viz.html`).
`-t, --title`	Graph title (default `parent/bundle` dir name).
`-l, --link`	Source URL shown in the header.
`--layout`	`cose`, `concentric`, `breadthfirst`, `circle`, `grid`.
`--max-nodes N`	Exit 1 above N concepts (useful in CI).
`--og-image URL`	Absolute URL for the social preview image.

Above 1,000 concepts the default switches to concentric (force freezes the page; --layout cose overrides, and the in-page picker asks first). Above 5,000 it warns that the page loads slowly and reads as a hairball, and suggests rendering a subdirectory.

Open it in any browser; ${CLAUDE_SKILL_DIR} resolves whether this runs as part of the okf plugin or as a standalone skills.sh skill. The page is deep-linkable: ?select=<concept-id> or #<concept-id> opens that concept, ?layout=<name> presets the layout.

---name: visualizedescription: Render an Open Knowledge Format (OKF) bundle as a single self-contained, interactive HTML graph (viz.html) — concepts as nodes coloured by type and sized by body length, markdown links and bundle-internal `sources` as edges, a wiki-style detail panel with rendered markdown, v0.2 trust/lifecycle/provenance metadata, and "Links to" / "Cited by" backlinks, layout switching, per-type filter and search. Use when asked to visualize, graph, preview, or explore an OKF bundle.---# Visualize an OKF bundleGenerate a self-contained HTML graph of the target bundle. The bundle directoryis required, so pass `.okf` explicitly when no path is given. No backend, noinstall, no bundle content leaves the page. The viewer does need networkaccess: cytoscape, marked and dompurify load from cdn.jsdelivr.net.```bashuv run "${CLAUDE_SKILL_DIR}/scripts/okf_visualize.py" $ARGUMENTS```If `uv` is unavailable:```bashpython3 -m pip install --quiet pyyaml && \python3 "${CLAUDE_SKILL_DIR}/scripts/okf_visualize.py" $ARGUMENTS```The detail panel shows each concept's `type`, `description`, `tags`, `status`,`generated`, `verified`, `stale_after`, `sources` (with their credibilitysignals, a `usage_count` alongside the `usage_window` that frames it), andrendered body; a `sources` entry pointing at another concept in the bundle alsobecomes a graph edge. A v0.1 `timestamp` is read as `generated.at`, so legacybundles still render fully.Two badges are **derived**, not read: the §5.3 trust tier(*unverified* / *machine-confirmed* / *human-reviewed*, keyed off the `human:`prefix in `verified[].by`) and staleness (`today >= stale_after`). They areadvisory signals — when reporting on a bundle, say which tier a concept is inrather than treating any of them as a gate.| Flag | Effect ||------|--------|| `-o <path>` | Output file (default `<bundle>/viz.html`). || `-t, --title` | Graph title (default `parent/bundle` dir name). || `-l, --link` | Source URL shown in the header. || `--layout` | `cose`, `concentric`, `breadthfirst`, `circle`, `grid`. || `--max-nodes N` | Exit 1 above N concepts (useful in CI). || `--og-image URL` | Absolute URL for the social preview image. |Above 1,000 concepts the default switches to `concentric` (force freezes thepage; `--layout cose` overrides, and the in-page picker asks first). Above5,000 it warns that the page loads slowly and reads as a hairball, andsuggests rendering a subdirectory.Open it in any browser; `${CLAUDE_SKILL_DIR}` resolves whether this runs as partof the `okf` plugin or as a standalone skills.sh skill. The page isdeep-linkable: `?select=<concept-id>` or `#<concept-id>` opens that concept,`?layout=<name>` presets the layout.

Frequently asked questions