visualize

Original：🇺🇸 English

Translated

1 scripts

Render an Open Knowledge Format (OKF) bundle as a single self-contained, interactive HTML graph (viz.html) — concepts as nodes coloured/sized by type, 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.

2installs

Sourcescaccogatto/okf-skills

Added on2026-08-17

NPX Install

npx skill4agent add scaccogatto/okf-skills visualize

SKILL.md Content

View Translation Comparison →

Visualize an OKF bundle

Generate a self-contained HTML graph of the target bundle (default the project's

.okf/

). No backend, no install on the viewing side, no data leaves the page.

bash

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

If

uv

is unavailable:

bash

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

The detail panel shows each concept's

status

,

generated

,

verified

,

stale_after

, and

sources

(with their credibility signals, a

usage_count

alongside the

usage_window

that frames it); 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.

The output defaults to

<bundle>/viz.html

. Pass

-o <path>

to write elsewhere. Bundles above 1,000 concepts default to the linear

concentric

layout (the force layout freezes the page at that size —

--layout cose

overrides), and

--max-nodes N

refuses oversized bundles, e.g. for CI. 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.

visualize

NPX Install

Tags

SKILL.md Content

Visualize an OKF bundle