visualize

Featured

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 382 stars 35 forks Updated 6 days ago MIT

Install

View on GitHub

Quality Score: 94/100

Stars 20%
86
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
2 months ago
Last Updated
6 days ago
Language
Python
License
MIT

Bundled in these plugins

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.

382 Updated 6 days ago
scaccogatto
Data & Documents Featured

okf-open-knowledge-format

Create, validate, and enrich Open Knowledge Format (OKF) bundles — the open spec for representing organizational knowledge as markdown files with YAML frontmatter. Use when the user mentions 'OKF', 'Open Knowledge Format', 'knowledge bundle', 'OKF bundle', 'create a knowledge base for agents', 'validate OKF', 'convert to OKF', 'enrich knowledge docs', 'agent-readable knowledge', 'LLM wiki', 'knowledge catalog', 'kcmd', or wants to structure knowledge as markdown files for AI agent consumption. Also use when the user has a directory of markdown files and wants to make them interoperable or conformant with the OKF standard. Even for simple requests like 'make this folder OKF conformant' — the skill has critical structural rules the agent needs.

77 Updated today
fabricioctelles
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`.

382 Updated 6 days ago
scaccogatto