The open spec for knowledge that ships.
A directory of markdown files. YAML frontmatter. Three rules. That's the entire format. Your AI agents parse it without adapters, your team reviews it in git, and your docs never rot outside context again.
Based on the Google Cloud Markdown spec · MIT licensed
├── index.md
├── what-is-okf.md
└── validation-rules.md
---
type: concept
title: What is OKF
---
# What is OKF
The Open Knowledge Format is a spec for
representing knowledge as markdown files.Why this exists
Most knowledge formats ask you to learn a schema, install an SDK, and migrate your content into a proprietary store. OKF asks you to keep writing markdown. The spec exists to make three guarantees:
- One index, one truth.
- Every bundle has an index.md that lists what's inside. Agents don't guess at structure — they read it.
- Typed frontmatter.
- Each file declares its type (concept, howto, reference, decision, metric). Agents route to the right handler without heuristics.
- Git-native history.
- Diff, branch, review knowledge like code. No proprietary format holds your content hostage. Semver protects your investment.
A bundle looks like this
# index.md — the entry point
---
title: My Knowledge Bundle
version: 0.1.0
entries:
- what-is-okf.md
- validation-rules.md
---
# My Knowledge Bundle
Everything an AI agent needs to know about…Validate before you ship
Paste or upload a bundle. Check conformance against three rules — in the browser. Zero backend, zero install. Know your bundle is correct before your agent reads it.
Open Validator →Teach your agent the spec
Install a skill that makes Claude, Codex, or Cursor produce conformant bundles. No system prompts, no fragile instructions. The agent ships correct output because it knows the format.
Install Skill →Ship your first bundle in two minutes.
Three files. One command to validate. Zero dependencies.