okf

# 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: ```bash 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: - `/okf read`: read the OKF bundle to load project context before planning or changing code. - `/okf init`: reorganize existing project documentation into an OKF-compliant `./docs` bundle and add AGENTS.md instructions for future agents. - `/okf update`: update the OKF bundle at the end of a session, feature branch, or PR so the docs reflect completed work. ## Required OKF shape for this skill Create and maintain these sections in every repository OKF bundle: ```text ./docs/ ├── index.md # Roadmap and top-level progressive-disclosure index ├── log.md # Chronological bundle update history, newest first ├── specs/ # Product specs, technical plans, issue plans, roadmaps │ ├── index.md ...