Built-in OKF schema

google:okf:0.1 is the Open Knowledge Format (OKF) v0.1 frontmatter schema shipped with docmeta. It anchors the default set: when no --schema, file $schema, or config rule applies, docmeta validates against google:okf:0.1 together with passo-uno:seven-action:1.0, which constrains an optional action field and adds no requirements of its own. For the other five schemas docmeta ships, see the built-in schema registry.

Property	Value
Id	google:okf:0.1
Title	Open Knowledge Format (OKF) v0.1
Dialect	Draft 2020-12
Additional properties	Allowed (additionalProperties: true)
Reference kind	builtin

OKF requires only type. Every other field is recommended, and unknown keys are explicitly tolerated, so a file may carry extra metadata without failing.

Fields

Field	Type	Format	Constraint	Status
type	string	—	minLength: 1	Required
title	string	—	—	Recommended
description	string	—	—	Recommended
resource	string	uri	—	Recommended
tags	array of string	—	—	Recommended
timestamp	string	date-time	—	Recommended

• type: a short string identifying the kind of concept; used for routing, filtering, and presentation. Must be a non-empty string.
• title: human-readable display name. When omitted, consumers may derive a title from the filename.
• description: single-sentence summary used for indexing and previews.
• resource: a URI uniquely identifying the underlying asset. Absent for abstract concepts.
• tags: short strings for categorization.
• timestamp: ISO 8601 date-time of the last meaningful change.

Note

Only type makes a file fail by default. The recommended fields are validated for format when present. A resource that is not a valid URI, or a timestamp that is not a valid date-time, fails, but their absence does not.

Example

A minimal file that passes against google:okf:0.1:

---
type: concept
---

A fuller file using the recommended fields:

---
type: concept
title: Schema resolution
description: How docmeta picks a schema set for each file.
resource: https://example.com/docs/schema-resolution
tags: [reference, schemas]
timestamp: 2026-06-25T12:00:00Z
---

Specification

google:okf:0.1 encodes the Open Knowledge Format v0.1 frontmatter contract. See the OKF specification for the full standard.