okf-authorlisted

# okf-author Author, convert, and validate **Open Knowledge Format (OKF)** documents — skill version **1.5.0**. OKF (Google Cloud, v0.1, released 2026-06-12) represents knowledge as a directory of Markdown files with YAML frontmatter. The authoritative specification is vendored next to this file at **`reference/SPEC.md`** and is the source of truth — when in doubt, read it. A deterministic conformance checker (**`validate.py`**) and an index/log generator (**`generate_indexes.py`**) ship alongside. ## When to use this skill - **Apply (no need to ask)** when the user mentions OKF, or the working directory is already an OKF bundle — detect that by a root `index.md`, files carrying `type:` frontmatter, or an `okf_version` declaration. In an OKF context, author and maintain documents in OKF automatically. - **Offer (ask first)** when the user is creating or substantially revising a Markdown knowledge / reference / notes / documentation file outside any OKF context. Offer once: *"I can structure this as OKF (portable Markdown knowledge with YAML frontmatter) — want that?"* Proceed only on a yes. Anti-nag rules: offer at most **once per directory per session**; never re-offer after a decline; skip trivial/throwaway files (scratch notes, TODO lists, transcripts), code, and prose the user has not asked to structure. All three modes below can also be invoked explicitly at any time on request. ## OKF in brief (authoritative detail in `reference/SPEC.md`) - A **bundle