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 on

NPX Install

npx skill4agent add scaccogatto/okf-skills visualize

Tags

Translated version includes tags in frontmatter
okf-bundle-visualizationinteractive-html-graphknowledge-graphmetadata-viewercli-tool

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.