Files

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

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

2026-06-16 20:35:29 +09:00

1.8 KiB

Raw Blame History

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

1.8 KiB Raw Blame History