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 73

Install: claude install-skill wagneripjr/skills

# okf-maintain — Adopt and Maintain an OKF Documentation Bundle ## Host and installed paths Claude Code invokes `okf-maintain:okf-maintain` through its Skill tool; Codex invokes `$okf-maintain:okf-maintain`. Resolve `<skill-dir>` to the absolute directory containing this installed `SKILL.md`, and substitute that path in every command below. Resolve `references/` relative to the same directory. Run the shared Node CLI through the host's terminal tool from the target repository; use native file/search tools for inspection and edits. No personal configuration or Claude environment variable is required. 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 manifest selec