OKF — Open Knowledge Format
Overview
Section titled “Overview”Open Knowledge Format (OKF) is a vendor-neutral spec (v0.1, announced June 12, 2026 by Sam McVeety & Amir Hormati at Google Cloud) that formalizes the “LLM Wiki” pattern into a portable, interoperable format. Represents knowledge as a directory of markdown files with YAML frontmatter. No SDK required — if you can cat a file, you can read OKF.
Each file = one “concept” (table, metric, playbook, API endpoint, etc.). The structure is a bundle (directory) with concepts linked via standard Markdown links. Google Cloud Knowledge Catalog natively ingests OKF bundles.
When to Use
Section titled “When to Use”- Create a knowledge base for AI agents
- Convert existing documentation to OKF format
- Validate OKF bundles against the specification
- Enrich Markdown docs with standardized frontmatter
- Structure wikis or knowledge bases as interoperable files
- Make organizational knowledge agent-readable
- Push bundles to Knowledge Catalog via kcmd CLI/MCP
Installation
Section titled “Installation”npx skills add https://github.com/fabricioctelles/skills -s okf-open-knowledge-formatFrontmatter Fields
Section titled “Frontmatter Fields”| Field | Required? | Description |
|---|---|---|
type |
YES | Kind of concept (free-form string: BigQuery Table, Metric, Playbook, etc.) |
title |
Recommended | Human-readable display name |
description |
Recommended | One-sentence summary |
resource |
Recommended | URI identifying the underlying asset |
tags |
Optional | YAML list for cross-cutting categorization |
timestamp |
Optional | ISO 8601 datetime of last meaningful change |
Bundle Structure
Section titled “Bundle Structure”my-bundle/├── index.md├── log.md├── tables/│ ├── index.md│ ├── users.md│ └── orders.md├── metrics/│ └── revenue.md└── playbooks/ └── onboarding.mdOperation Modes
Section titled “Operation Modes”| Mode | Description |
|---|---|
create |
Create OKF bundle from scratch based on description |
convert |
Convert existing Markdown directory to OKF conformant |
validate |
Check conformance against the spec (3 rules) |
enrich |
Add missing frontmatter, schema, citations, and cross-links |
serve |
Push bundles to Knowledge Catalog via kcmd |
Knowledge Catalog Integration
Section titled “Knowledge Catalog Integration”Google Cloud’s Knowledge Catalog natively ingests OKF. The skill knows how to use kcmd (CLI + MCP server) for push/pull of bundles, allowing any MCP-compatible agent to access the catalog.
Origin
Section titled “Origin”Spec created by Sam McVeety & Amir Hormati (Google Cloud, June 12, 2026). Formalizes the “LLM Wiki” pattern (Karpathy’s gist) into an interoperable format. Apache 2.0 license.