OKF documentation

Own the x9 OKF metadata contract: each document's header carries enough for an agent to decide whether to open it. Own also the block between  and  in a repository's AGENTS.md, written from the block template, so every repository states the same rules in the same words. Preserve document bodies and act only on the documents in scope.

Read the contract before writing any metadata.

Choose the route

Create a document, work on one, or bring the repository's AGENTS.md block up to date: maintain.
Adopt a folder, check it, or remove retired fields: adapt.
Brief a read-only subagent that proposes metadata: proposal brief.

Runtime

The package-owned skills/x9-okf-docs directory is canonical. Writing a header by hand needs no tools. The scripts need Python 3.9 or newer and Ruby with Psych, which stock macOS provides; resolve their paths from this loaded skill directory and run scripts/check_dependencies.py before the first script in a session. The onboarding declaration lists these prerequisites.

Completion

Only the intended files changed, bodies kept their bytes, BOM, and line endings where a script wrote, and the validator passes for the documents in scope. When a needed script cannot run, report the metadata as unchecked rather than skipping silently.