okf-knowledge-base

Open Knowledge Format (OKF)

OKF v0.2 is a portable format for agent-readable knowledge: Markdown files, YAML frontmatter, and standard links. The /open-knowledge skill governs tool use; this skill covers OKF semantics.

Core rules

• A bundle is a directory tree of .md files. Each non-reserved file is one concept; its path without .md is its ID.
• Every concept needs parseable frontmatter with a non-empty string type. No other field is always required.
• Types are an open vocabulary. Consumers must accept unfamiliar types and metadata.
• Use standard Markdown links for portable relationships. Broken links and a missing index are allowed.
• index.md and log.md are reserved at every level. Use lowercase filenames.
• An index.md normally has no frontmatter; only the root index may declare okf_version: "0.2".
• A log.md is newest-first; entry headings begin with an ISO date — ## YYYY-MM-DD: Summary (the summary after the date is optional; a bare ## YYYY-MM-DD is equally conformant).
• OKF consumers read .md, not .mdx.

Authoring judgment

Open Knowledge Format (OKF)

OKF v0.2 is a portable format for agent-readable knowledge: Markdown files, YAML frontmatter, and standard links. The /open-knowledge skill governs tool use; this skill covers OKF semantics.

Core rules

• A bundle is a directory tree of .md files. Each non-reserved file is one concept; its path without .md is its ID.
• Every concept needs parseable frontmatter with a non-empty string type. No other field is always required.
• Types are an open vocabulary. Consumers must accept unfamiliar types and metadata.
• Use standard Markdown links for portable relationships. Broken links and a missing index are allowed.
• index.md and log.md are reserved at every level. Use lowercase filenames.
• An index.md normally has no frontmatter; only the root index may declare okf_version: "0.2".
• A log.md is newest-first; entry headings begin with an ISO date — ## YYYY-MM-DD: Summary (the summary after the date is optional; a bare ## YYYY-MM-DD is equally conformant).
• OKF consumers read .md, not .mdx.

Authoring judgment