okf-author v1.4.1

okf-author v1.4.1 is a documentation patch.

It expands the README's plugin-install instructions to make the auto-update step conscious: self-hosted marketplaces have auto-update off by default, so you have to enable it in the /plugin interface (Marketplaces → okf-author → Enable auto-update). The notes now spell out the exact menu path, that Claude Code refreshes at session start (start a fresh session to apply a new version), and the manual fallback — claude plugin marketplace update, then claude plugin update okf-author@okf-author — for when auto-update is off.

All version markers bumped to 1.4.1 in lockstep so the release matches main. No skill or plugin behavior change; example bundle still CONFORMANT (default + --strict); claude plugin validate --strict clean.

Install / update

Claude Code (plugin, auto-updating):

/plugin marketplace add parkscloud/okf-author
/plugin install okf-author@okf-author

Already installed with auto-update enabled? Claude Code refreshes it at session start. Codex / manual: python3 install.py --all.

okf-author v1.4.0

okf-author v1.4.0 sharpens how the skill writes the timestamp frontmatter field (decision D12).

Authoring / live-editing a document now records the actual current UTC time — real time of day, trailing Z — read from the system clock (date -u +%Y-%m-%dT%H:%M:%SZ), instead of defaulting to 00:00:00 or a local-timezone offset. Converting an existing document records the source file's last-modified date at midnight UTC (...T00:00:00Z), an honest date-level precision when the modification time of day is unknown. Always UTC Z, never a local offset.

This was researched, not assumed: the vendored OKF spec (§4.1) defines timestamp as the ISO 8601 datetime of last meaningful change, every spec example uses UTC Z (two with a real time of day), and Google's upstream reference bundles all carry real, to-the-second UTC times (verified live). The bundled validate.py already accepts every UTC form (it only warns on non-ISO values), so the validator is unchanged.

Updated SKILL.md (new Timestamps section + Author/Convert guidance + template comment) and recorded D12 in DESIGN.md. All version markers bumped to 1.4.0 in lockstep. Example bundle still CONFORMANT (default + --strict); claude plugin validate --strict clean.

Install / update

Claude Code (plugin, auto-updating):

/plugin marketplace add parkscloud/okf-author
/plugin install okf-author@okf-author

Already installed with auto-update enabled? Claude Code refreshes it at session start. Codex / manual: python3 install.py --all.

okf-author v1.3.1

okf-author v1.3.1 is a patch release that aligns the latest GitHub release with main. It folds in the README status/install badges and bumps all version markers (README, SKILL.md, validate.py, generate_indexes.py, plugin.json, marketplace.json, DESIGN) to 1.3.1 in lockstep. No change to skill or plugin behavior. Validated with claude plugin validate --strict.

okf-author v1.3.0

okf-author v1.3.0 packages the project as a Claude Code plugin with a self-hosted marketplace, so you can install it — and opt into auto-update — directly:

/plugin marketplace add parkscloud/okf-author
/plugin install okf-author@okf-author

Enable auto-update for the okf-author marketplace in /plugin and Claude Code refreshes it at session start. The skill/ directory was renamed to skills/ for default plugin discovery; install.py is unchanged and remains the path for Codex and manual installs (Codex has no plugin system). Validated with claude plugin validate --strict. See decision D11 in DESIGN.md.

No change to the skill behavior itself (Author / Convert / Validate) — this is a distribution + discoverability release.

okf-author v1.2.0

okf-author v1.2.0 recommends relative cross-links over bundle-absolute /-rooted links (decision D10). GitHub and other forges resolve a /-rooted link against the repository root, so bundle-absolute links break whenever the bundle is a subdirectory — verified live. Updated the SKILL.md link guidance, templates, and the examples/handbook bundle to use relative links; generate_indexes.py already emitted them, and validate.py accepts both forms (both are conformant per OKF §5.1–5.2). Also corrected the DESIGN §5 repo-layout tree (added CLAUDE.md + generate_indexes.py; dropped the never-created docs/).

okf-author v1.1.0

okf-author v1.1.0 adds generate_indexes.py — deterministically (re)generates per-folder index.md + log.md and the bundle-root index.md (okf_version) from concept frontmatter, automating the structural half of OKF conversion. Dependency-free (PyYAML optional); flags --title / --okf-version / --no-logs / --dry-run. Wired into Convert mode.

okf-author v1.0.1

Patch: validate.py now URL-decodes link targets, so percent-encoded intra-bundle links (e.g. spaces as %20) resolve instead of being flagged as broken. No change to authoring/conversion behavior.

okf-author v1.0.0

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.