feat(okf): add SKILL.md variants (top/code/desktop), CLAUDE.md, README

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

custom-skills/97-ourdigital-okf/README.md

@@ -0,0 +1,51 @@
+# 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
+
+```bash
+./install.sh
+```
+
+Symlinks the skill into `~/.claude/skills/ourdigital-okf`. Invoke with `/ourdigital-okf`.
+
+## Scripts (Python standard library only — no pip install)
+
+```bash
+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/`:
+
+```bash
+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>