# Okf Knowledge Base

Open Knowledge Format (OKF) v0.2 guidance.

- Repository: https://github.com/inkeep/open-knowledge (4756 stars)
- Category: Engineering
- License: GPL-3.0
- Last updated: 2026-10-31
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add inkeep/open-knowledge --skill okf-knowledge-base -g -a claude-code -y`
Codex: `npx skills add inkeep/open-knowledge --skill okf-knowledge-base -g -a codex -y`
Cursor: `npx skills add inkeep/open-knowledge --skill okf-knowledge-base -g -a cursor -y`
Gemini CLI: `npx skills add inkeep/open-knowledge --skill okf-knowledge-base -g -a gemini-cli -y`

## Description

Open Knowledge Format (OKF) v0.2 guidance. Use when creating, reading, reviewing, or maintaining an OKF bundle; responding to OpenKnowledge `okf` plugin warnings; or choosing types, provenance, links, indexes, or logs.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Open Knowledge Format (OKF)

[OKF v0.2](https://github.com/GoogleCloudPlatform/open-knowledge-format/blob/main/SPEC.md) 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

The rest: https://github.com/inkeep/open-knowledge/blob/HEAD/packages/server/assets/skills/packs/okf/SKILL.md