okf-knowledge-format SKILL.md skillA

okf-knowledge-format from ejklock/living-docs-skill is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add ejklock/living-docs-skill/okf-knowledge-format@v0.1

Pins v0.1 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
ejklock/living-docs-skill
Path
skills/okf-knowledge-format/SKILL.md
Versions recorded
5
Latest version
v0.1, committed Sep 18, 2026
First version recorded
Aug 14, 2026
Size
3,806 bytes
Repository stars
14
License
a license file GitHub does not identify

Author and validate knowledge as OKF (Open Knowledge Format) bundles — a directory of markdown files with YAML frontmatter, where every concept is one .md file with a REQUIRED `type` field, reserved index.md/log.md files, bundle-relative cross-links, and a permissive conformance model. Use when standing up or maintaining a knowledge bundle/catalog, writing or normalizing a concept document's frontmatter, deciding how to structure markdown knowledge for agents to consume, or checking a corpus…

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# OKF — Open Knowledge Format

Represent knowledge as an **OKF bundle**: a directory tree of UTF-8 markdown files with YAML frontmatter, designed to be read by humans, written by agents, and exchanged across organizations with no required tooling. "If you can `cat` a file, you can read OKF." This skill is the repo's standard for *how knowledge markdown is structured* — frontmatter shape, reserved files, cross-links, and conformance.

The authoritative rules live in the vendored spec at `reference/SPEC.md` (OKF v0.1). This SKILL.md is the operational summary; when a detail is ambiguous, open `reference/SPEC.md` and follow it.

> **Provenance — not ours.** OKF is a published, vendor-neutral standard from **Google Cloud Platform** (OKF v0.1, 2026-06-12), not a format coined in this repo. We adopt and vendor it (`reference/SPEC.md` is refreshed from upstream via `scripts/update-spec.sh`). Source: GOOGLE CLOUD PLATFORM, *Open Knowledge Format — Specification v0.1* — full citation in `../../references/prior-art-landscape.md`.

---

## Using this skill (progressive disclosure)
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add ejklock/living-docs-skill/okf-knowledge-format@sha256:df1d26c4dc201a63

The line at the top of this page pins the label v0.1, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_fgjwyfckgruahlqk.svg)](https://markdownregistry.com/a/art_fgjwyfckgruahlqk)

1 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 5 versions of this file, between Aug 14, 2026 and Sep 18, 2026, about one every 9 days.

versioncommittedcommitsizeaudit
v0.1 latest2026-09-18 62c5ad4 3,806 BA view · diff
v0.12026-08-28 db6db72 3,827 BA view · diff
v0.13.02026-08-27 5bc2dd0 3,830 BA view · diff
v0.12.02026-08-14 5157bb6 3,830 BA view · diff
v0.11.02026-08-14 a82c0aa 3,830 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (3806 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

ejklock/living-docs-skill · 14 stars · license a license file GitHub does not identify · pushed 2026-11-07 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_fgjwyfckgruahlqk
GET https://markdownregistry.com/api/v1/resolve?ref=ejklock/living-docs-skill/okf-knowledge-format
GET https://markdownregistry.com/api/v1/blob/df1d26c4dc201a637a4344969bfb98210b0a2d9b0f42404f5e97e7039839d693

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from ejklock/living-docs-skill

CLAUDE.md CLAUDE.md file
ejklock/living-docs-skill · CLAUDE.md
git:20260918.62c5ad4 · audit A · 14 stars
living-docs SKILL.md skill
ejklock/living-docs-skill · skills/living-docs/SKILL.md · Run a project's engineering decisions as a living log — MADR-lite ADRs (supersede, never delete) for decisions…
v0.25.3 · audit A · 14 stars
research-artifacts SKILL.md skill
ejklock/living-docs-skill · skills/research-artifacts/SKILL.md · Organize, format, and index research as OKF-conformant knowledge bundles — dated, sourced, append-only snapshots of the…
v0.25.3 · audit A · 14 stars

Every file in ejklock/living-docs-skill

Browse by kind, by grade A, or by owner.