ourdigital-okf
A custom OurDigital Claude skill for Google Open Knowledge Format (OKF) v0.1 — produce, validate, and visualize knowledge bundles (directories of markdown concept files with YAML frontmatter).
Modes
| Mode | What it does |
|---|---|
| produce | Claude drafts a conformant OKF bundle from a pasted/exported schema, a docs folder, or a /reference-curator research topic. |
| validate | Lints a bundle for OKF v0.1 conformance (parseable frontmatter + non-empty type); reports broken cross-links as warnings. |
| visualize | Renders a bundle as a self-contained interactive Cytoscape graph (viz.html). |
Install
./install.sh
Symlinks the skill into ~/.claude/skills/ourdigital-okf. Invoke with /ourdigital-okf.
Scripts (Python standard library only — no pip install)
python3 code/scripts/okf_validate.py <bundle> [--json]
python3 code/scripts/okf_viz.py --bundle <bundle> [--out viz.html] [--name "Name"]
Run the tests from code/scripts/:
python3 -m unittest discover -s tests
The suite is verified against Google's three reference bundles mirrored at
~/Documents/reference-library/open-knowledge-format/okf/bundles/ (crypto_bitcoin, ga4,
stackoverflow).
Layout
SKILL.md— canonical entry;code/SKILL.md— detailed Claude Code flows;desktop/— Claude Desktop variant.code/references/— distilled OKF spec + frontmatter reference.code/assets/— concept/index/log templates.code/scripts/—okf_common.py,okf_validate.py,okf_viz.py+ tests.DESIGN.md— approved design spec.docs/IMPLEMENTATION-PLAN.md— build plan.
Reference
OKF spec and reference implementation: https://github.com/GoogleCloudPlatform/knowledge-catalog/tree/main/okf