Open Knowledge Format

OKF is a simple file format for AI-ready knowledge.

Open Knowledge Format gives teams a plain, portable way to package context, metadata, sources, trust signals, and useful explanations for AI tools.

The short version

OKF turns a folder of markdown files into a small knowledge system. People can read it, agents can parse it, and teams can move it between tools without needing a proprietary runtime.

  • Knowledge lives in ordinary markdown files
  • YAML frontmatter adds useful metadata
  • Links connect related concepts
  • Sources, verification, and freshness notes help readers judge trust

Why it matters for AI

AI systems are often limited by missing or scattered context. OKF gives builders and teams a repeatable way to supply that context before asking an assistant or agent to do important work.

  • Less repeated context assembly
  • More visible provenance than loose prompts
  • A readable base for review and improvement
  • A portable handoff between creators, teams, tools, and agents

Why the marketplace reviews bundles

KnowledgeBundles uses OKF as the structure, then adds discovery, commerce, creator accountability, and quality review around the format.

  • Checks for required structure and useful metadata
  • Review signals for source, licence, and provenance quality
  • Creator feedback before publication
  • Buyer-facing trust notes on listing pages

What OKF is not

OKF is not another closed knowledge-base product. It is the exchange format underneath the work: a way to make knowledge easier to inspect, version, share, and consume.

  • Not tied to one model provider or cloud platform
  • Not a replacement for domain-specific schemas
  • Not a guarantee that every claim is correct
  • Not useful without good source material and review

Plain-English explanation

Google's point: AI does better when context can travel.

Google introduced OKF because useful AI work depends on the context around a task: what a table means, how a metric is calculated, which policy applies, where a claim came from, and whether the information is still current. Their argument is that this context should not be trapped inside one wiki, one catalogue, one app, or one vendor.

1

OKF is a format, not a platform.

The Google explanation says the answer is not another knowledge service. OKF is a shared way to represent knowledge so different producers and consumers can exchange it without a custom integration each time.

2

The files stay ordinary.

An OKF bundle is a directory tree of markdown files. Each concept is one file, and the metadata lives in YAML frontmatter at the top. If a person can open a text file, they can inspect the bundle.

3

The structure gives agents handles.

Fields such as type, title, description, resource, and tags help tools route, preview, search, and explain the content instead of treating it as loose text.

4

The trust signals are visible.

The current OKF spec makes provenance, verification, freshness, and lifecycle status first-class. In plain English: the bundle can show what the knowledge came from, who or what checked it, and whether it may be stale.

The problem OKF tries to solve.

Most organisations already have useful knowledge, but it is spread across catalogues, wikis, shared drives, code comments, notebooks, and people's heads. Agents then have to reconstruct the same background over and over before they can answer well.

What makes it portable.

OKF uses formats teams already understand: folders, markdown, frontmatter, links, index files, and logs. That makes the knowledge easier to version, review, search, copy, publish, and load into different workflows.

What changed since the launch post.

Google's launch article introduced OKF v0.1. The public spec is now v0.2 and adds more explicit support for provenance, trust, lifecycle, freshness, and attested computation while keeping the basic idea minimal.

How this connects to Knowledge Bundles.

A Knowledge Bundle is the commercial, buyer-facing package. OKF is the structure underneath it. The marketplace can then review whether the bundle is readable, source-aware, portable, and useful before sending buyers to download or request one.

Simple shape

An OKF bundle can be as simple as a folder of concepts.

The folder gives the bundle structure. The frontmatter gives tools quick metadata. The markdown body explains the concept in human language.

bundle/
  index.md
  log.md
  playbooks/
    onboarding.md
  references/
    source-notes.md

---
type: Playbook
title: Customer onboarding
sources:
  - id: policy
    resource: /references/source-notes.md
verified:
  - { by: human:reviewer, at: 2026-08-16T09:00:00Z }
status: stable
---

Google source

This idea comes from Google's OKF work.

Google Cloud introduced Open Knowledge Format as an open, portable way to represent the metadata, context, and curated knowledge that AI systems need. The launch article introduced v0.1; the public spec is now v0.2 and describes a minimal structure based on markdown files, YAML frontmatter, links, provenance, trust, lifecycle, and freshness signals.

Next step

Move from learning to useful AI-ready knowledge.