OKF

Use this skill to read, initialize, or update an Open Knowledge Format bundle for a repository.

Before editing, read references/SPEC.md from this skill directory. Treat that file as the source of truth for OKF v0.1 conformance.

When validating a bundle, use the bundled helper when available:

python <skill-dir>/scripts/validate_okf.py <repo-root>

Use --strict-links when broken local Markdown links should fail validation instead of warn.

Core idea

An OKF bundle is a directory tree of Markdown files with YAML frontmatter for concept documents, plus index.md and log.md files for navigation and history. In repositories, the bundle root is ./docs unless the user explicitly chooses another path.

The skill has three workflows: