okf

okf

A Claude Code skill for working with the Open Knowledge Format (OKF) — vendor-neutral knowledge represented as a directory of markdown files with YAML frontmatter. No schema registry, no SDK, no required tooling: if you can cat a file you can read OKF; if you can git clone a repo you can ship it.

The skill teaches the OKF mental model (bundle, concept, concept-id, links, reserved files) and walks through authoring concept documents, index.md/log.md, citations, and conformance validation.

Install

Via the mattjoyce-plugins marketplace:

/plugin marketplace add mattjoyce/claude-plugins
/plugin install okf

Use

Invoke the skill whenever you create an OKF bundle, author a concept document, build a knowledge bundle/catalog as markdown, or check OKF conformance.

Validate a bundle directly:

python3 skills/okf/scripts/validate_okf.py <bundle-dir> --strict --check-links

• --strict — also require title/description/timestamp (the reference producer's rule).
• --check-links — report dangling intra-bundle links as informational notices (never affects the conformance verdict; OKF treats broken links as not-yet-written knowledge).

Layout

skills/okf/
├── SKILL.md                  # the skill instructions
├── references/
│   ├── spec-quickref.md      # OKF v0.1 fields, reserved files, conformance checklist
│   └── tooling.md            # optional accelerators (not required to produce/read OKF)
├── scripts/
│   └── validate_okf.py       # dependency-free conformance + link validator
└── examples/minimal_bundle/  # a complete, validator-passing bundle

License

Apache-2.0.