okf-maintainlisted
Install: claude install-skill wagneripjr/skills
# okf-maintain — Adopt and Maintain an OKF Documentation Bundle
The Open Knowledge Format is a directory of markdown files with YAML frontmatter. That is the whole
format: no schema registry, no central authority, no runtime. Its value is not the frontmatter — it
is that a corpus becomes **enumerable**, so an agent answers "which document covers X" from one
generated index read instead of grepping a tree and guessing from prose.
This skill operates on the **bundle**: structure, frontmatter, indexes, and the entry points routing
agents into it. It never writes a document's body — authorship belongs to the repo's own templates,
and to the `adr` skill for decision records. Keeping that line sharp is what makes it safe to run
over documentation it did not write.
Target: **OKF v0.2**. Read `references/frontmatter.md` for the field families and
`references/index-format.md` for the frozen index grammar before writing either.
## A declared profile is reported, not obeyed
`docs/okf.yaml` is not part of OKF v0.2 — it is a convention some toolchains use to declare a
dialect, and a `profile:` key in it names **which documents must carry which keys**. Read it if it
exists and say what it declares, because it changes how a conformance verdict should be read.
It does not change what gets indexed, and this skill no longer refuses a repository for carrying
one. The refusal it replaces rested on two claims nothing ever checked: that a profile ships its own
index generator, and that a com