visualize

Solid

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.

AI & Automation 100 stars 18 forks Updated today MIT

Install

View on GitHub

Quality Score: 90/100

Stars 20%
67
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
77
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

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

Details

Author
scaccogatto
Repository
scaccogatto/okf-skills
Created
1 months ago
Last Updated
today
Language
Python
License
MIT

Similar Skills

Semantically similar based on skill content — not just same category

AI & Automation Featured

okf

Author, maintain, and consume Open Knowledge Format (OKF) knowledge bundles — portable markdown + YAML frontmatter that both humans and agents read. Use when capturing project knowledge (services, APIs, schemas, metrics, runbooks, decisions) into an OKF bundle, when updating one after code or docs change, or when a repository contains an `.okf/` (or other OKF) bundle that should inform the task. Triggers on: "document this in OKF", "update the knowledge bundle", "capture this as a concept", or any work in a repo that has an OKF bundle.

100 Updated today
scaccogatto
AI & Automation Featured

validate

Check that an Open Knowledge Format (OKF) bundle is conformant with the v0.2 spec (§11). Use when asked to validate, lint, or check an OKF bundle, or before committing changes to one. Runs a deterministic Python checker — not an eyeball pass. Also migrates a v0.1 bundle to v0.2 in place with `--migrate`.

100 Updated today
scaccogatto
Data & Documents Listed

okf-knowledge-format

Author and validate knowledge as OKF (Open Knowledge Format) bundles — a directory of markdown files with YAML frontmatter, where every concept is one .md file with a REQUIRED `type` field, reserved index.md/log.md files, bundle-relative cross-links, and a permissive conformance model. Use when standing up or maintaining a knowledge bundle/catalog, writing or normalizing a concept document's frontmatter, deciding how to structure markdown knowledge for agents to consume, or checking a corpus against OKF conformance. The canonical spec is vendored under reference/SPEC.md and refreshed from GitHub via scripts/update-spec.sh.

8 Updated 4 days ago
ejklock