OKF Builder Reference / Open Knowledge Format v0.2, explained for builders OKF v0.2
OKF OpenKnowledgeFormat

Comparison

OKF vs llms.txt

llms.txt gives LLMs a curated entry point into website content. OKF can map concept-level knowledge and the relationships a flat page list drops.

Question
OKF
llms.txt
Primary job
Packages concepts and their relationships into reusable files.
Points LLMs toward important website pages.
Scope
Repos, docs, data, operations, APIs, playbooks, website concepts, and relationships.
Website content discovery and summaries.
Structure
Many concept files with metadata and Markdown links.
One entry-point text file.

When to use OKF

Use OKF when the knowledge needs structure, metadata, links, and a map of how concepts fit together.

When to use llms.txt

Use llms.txt when you want to guide models through public website content.

How they work together

A site can publish llms.txt as the entry point and link to an OKF bundle for deeper structured context, giving models both a page map and concept-level relationships.

Validation checklist

How do you validate llms.txt and OKF?

There is no single universal llms.txt validator. A useful check follows the proposal and tests whether models can reliably discover its links. OKF validation has a separate conformance floor defined by the canonical specification.

Check llms.txt

Confirm that /llms.txt is reachable as plain text, follows the proposed heading, summary, section, and Markdown-link structure, and points to URLs that resolve.

Check the OKF bundle

Confirm that concept files have parseable YAML frontmatter and a non-empty type, and that reserved files follow their defined structures. Then review advisory findings for metadata, provenance, trust, lifecycle, and links.

Use both when useful

Use llms.txt to expose the important public entry points, link it to the OKF bundle, and validate each format separately. The OKF bundle can then supply deeper concepts, relationships, and source context.

Implementation example

What this looks like in a working system.

A documentation site can list its main guide and OKF bundle in `/llms.txt`. An agent uses the file to discover the relevant entry points, then traverses the OKF index and concept links when it needs definitions, provenance, or operational context.

Boundary

What this comparison does not claim.

llms.txt is a proposal for website content discovery, not a general knowledge-bundle schema. OKF does not replace a concise public entry point and cannot make a bundle discoverable unless a site or tool links to it.

Primary sources

Check both formats directly.

Comparison reviewed 2026-08-31.

Related comparisons

Keep the boundaries straight.

Mathias Onea

Mathias Onea

Senior Engineer, Product Builder, and Founder

Systems, product software, and practical execution for teams that need clear decisions, durable implementation, and agent-ready knowledge structures.

Focus
Knowledge systems, Laravel platforms, automation, and technical SEO infrastructure.
Related work
Founder-led software work through Craftwell and independent open-source projects.
Profile
mathiasonea.com