Visualize

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.

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 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.