← ClaudeAtlas

okf-maintainlisted

Use when adopting the Open Knowledge Format (OKF v0.2) in a repository, or maintaining a documentation bundle already in it: bootstraps a conformant tree, stamps and repairs YAML frontmatter, regenerates every index.md bottom-up so no document goes unlisted, excludes paths another tool owns via .okfignore, removes log.md and strips changelog/history sections because git already holds history losslessly, and wires CLAUDE.md/AGENTS.md/GEMINI.md to the root index so agents stop grepping for a document's identity. Ships a conformance check that fails closed, plus a coverage check that names every document no index reaches. Triggers on: 'set up OKF', 'make these docs OKF-conformant', 'regenerate the docs index', 'add frontmatter to the docs', 'which docs are missing from the index', 'our documentation keeps drifting'. NOT for writing a document's body or deciding its content - repo templates and the adr skill own that. NOT for reverse-engineering a codebase into fresh specs.
wagneripjr/skills · ★ 0 · AI & Automation · score 75
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