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/prov
By scaccogatto · 548 installs
npx skills add scaccogatto/okf-skills --skill visualize
Source repository · Upstream listing
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.
If uv is unavailable:
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.