Skip to content

okf-author v1.0.0

Choose a tag to compare

View all tags
@parkscloud parkscloud released this 20 Jun 20:12
· 8 commits to main since this release
v1.0.0
4380cbe

okf-author v1.0.0 — a cross-agent Agent Skill for authoring, converting, and validating Markdown in Open Knowledge Format (OKF) from inside Claude Code and Codex.

OKF (Google Cloud, v0.1) represents knowledge as a directory of Markdown files with YAML frontmatter. okf-author makes the documents an agent writes conform from the start, and brings existing Markdown into conformance on request.

Install

git clone https://github.com/parkscloud/okf-author
cd okf-author
python3 install.py --all      # Claude Code + Codex  (use python on Windows)

In this release

  • SKILL.md — one skill, three modes: Author, Convert, Validate. It applies OKF when you mention it or work inside an OKF bundle, and otherwise offers it once for substantial Markdown.
  • validate.py — dependency-free OKF v0.1 §9 conformance checker (PyYAML used only if already installed); supports --strict, --json, --quiet.
  • install.py — cross-platform installer for Claude Code (~/.claude/skills/) and Codex (~/.agents/skills/).
  • reference/SPEC.md — the OKF v0.1 specification, vendored verbatim (Apache-2.0, © Google LLC), with provenance recorded.
  • examples/handbook — a tiny conformant example bundle.

Verified against Google's published OKF bundles, deliberately broken fixtures, and an end-to-end conversion of real Markdown. MIT licensed.

Assets 2
Loading