OKF — Open Knowledge Format

Overview

Open Knowledge Format (OKF) is a vendor-neutral spec (v0.1, June 2026, Google Cloud) for representing 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.

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

Installation

npx skills add https://github.com/fabricioctelles/skills -s okf-open-knowledge-format

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

Bundle Structure

my-bundle/
├── tables/
│   ├── users.md
│   └── orders.md
├── metrics/
│   └── revenue.md
├── playbooks/
│   └── onboarding.md
└── README.md

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
enrich	Add missing frontmatter and suggest links between concepts

Origin

Specification created by Google Cloud (June 2026). Full spec included as a bundled reference in the skill.

📄 Full documentation on GitHub