OKF Knowledge Base skill for Claude Code: write Open Knowledge Format files

Teaches Claude the rules of Open Knowledge Format v0.2 so it can write, read and review Markdown knowledge bases correctly.

Installs: 9.3K; on skills.sh
Stars: 15; on GitHub
Files: 1; besides SKILL.md
Updated: Oct 2026; last repo commit

This skill from Inkeep tells Claude how Open Knowledge Format (OKF) v0.2 works. An OKF bundle is a folder of Markdown files with YAML frontmatter, where each file is one concept. The skill covers required frontmatter, links, reserved index.md and log.md files, and how to record sources and who verified a claim.

It loads when you create, read, review or maintain an OKF bundle, or when the optional okf plugin shows warnings. Its compatibility line says it expects the OpenKnowledge MCP server to be configured, and it leaves tool use to a separate /open-knowledge skill. It bundles no scripts.

Good for

Teams keeping an agent-readable knowledge base as Markdown files
Anyone fixing warnings from the OpenKnowledge okf plugin
Authors who need provenance and sources recorded honestly

Install okf-knowledge-base

Claude Code

Copy this prompt.

Install the okf-knowledge-base skill in Claude Code. Run this command:

/plugin marketplace add inkeep/open-knowledge-skills
/plugin install okf-knowledge-base@open-knowledge-skills

Then check that it loaded and tell me how to use it.

2
Paste it into Claude Code. It shows the change and asks before running it.

The skill expects the OpenKnowledge MCP server to be configured, and a separate /open-knowledge skill governs tool use. The pack README also lists "ok seed --pack okf" to seed a project. We store no Claude app upload because the skill works on a bundle of files.

From the project README. Source.

What's in the skill

When it loads

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.

Sections in SKILL.md

Core rules
Authoring judgment
Read and maintain a bundle
OpenKnowledge's okf plugin

Key facts

Author: Inkeep (SKILL.md metadata)
License: MIT (LICENSE file)
Installs on skills.sh: 9,270 as of 2026-11-02
GitHub stars: 15 for the repo, 2026-11-02
skills.sh audits: Gen Agent Trust Hub pass, Socket pass, Snyk pass
What is inside: 2 files in the skill folder: SKILL.md and plugin.json (no scripts)
Needs: The OpenKnowledge MCP server configured in your agent host; the okf plugin is optional
Spec: OKF v0.2 from Google Cloud Platform on GitHub
Last repo commit: 2026-10-27

What it includes

Eight rules for bundles, types, links and reserved files
A bundle is a folder of .md files. Each needs a non-empty string type in its frontmatter. index.md and log.md are reserved, and OKF consumers read .md, not .mdx.
Read · Core rules
Eight rules on types, provenance and timestamps
Do not invent facts or sources. Record sources in sources, keep generated and verified separate, and write every provenance timestamp as ISO 8601 with a UTC offset.
Try: “Add a concept file for our billing service and record where each fact came from.”
Write · Authoring judgment
Start at index.md, follow only relevant links
Claude writes durable discoveries back to the right concept and adds a dated log.md entry after lasting changes when the bundle uses a log.
Try: “Review this OKF bundle and list what breaks the format.”
Write · Read and maintain a bundle
How to act on the optional plugin's warnings
The plugin checks structure, frontmatter, reserved files, links and .mdx use. Claude should read the .ok/okf schema files, not edit them, and never edit generated indexes. SKILL.md says the plugin is off by default.
Read · okf plugin guidance

From the official docs

Permissions

Low risk

Claude writes to the Markdown files in your knowledge base. Keep the folder in git so you can review changes.

What it can do

Read your data
Create and change things
Delete things
Read-only mode

Watch out for

It edits files in your knowledge base
SKILL.md tells Claude to write discoveries back to concept files and add log entries. Keep the bundle in git and review the diff. github.com
The okf plugin is a separate install
The plugin is optional and off by default per SKILL.md. The marketplace entry named okf is marked OUTDATED and renamed okf-knowledge-base. github.com

Security advisories

No published security advisories as of Nov 2, 2026.

Technical details

Turning on read-only	SKILL.md defines no read-only mode.
Scopes	Claude reads and writes Markdown concept files and log.md entries in your OKF bundle The optional okf plugin adds write-time warnings and project audits

Questions

What is the okf-knowledge-base skill?

A guide from Inkeep that makes Claude follow Open Knowledge Format v0.2 when it writes or reviews a Markdown knowledge base. It covers frontmatter, links, provenance, indexes and logs.

How do I install it in Claude Code?

Use the install box at the top of the page. The README's plugin command installs only this skill, since the okf-knowledge-base plugin in the marketplace lists one skill.

Does it need the OpenKnowledge MCP server?

The compatibility line says it works with any agent host that has the OpenKnowledge MCP server configured. SKILL.md says a separate /open-knowledge skill governs tool use, and this one covers OKF rules.

Is it the same as the okf plugin?

No. The okf plugin is OpenKnowledge software that checks your files and shows warnings. SKILL.md says it is optional and off by default. The skill explains the format and how to act on those warnings.

Is it safe?

It bundles no scripts, but it tells Claude to write concepts and log entries back into your knowledge base. Keep the bundle in git so you can review what Claude changed.

Does it work in Claude.ai or Codex?

The README says you can copy any skill into .claude/skills, .cursor/skills, .codex/skills or .agents/skills. We store no Claude app upload because the skill works on a bundle of files in a project.

Information

updated Nov 2, 2026

Repository: inkeep/open-knowledge-skills
Folder: skills/starter-packs/okf-knowledge-base/okf-knowledge-base

inkeep/open-knowledge-skills skills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 4

okf pack README · github.com
README · github.com
okf-knowledge-base SKILL.md · github.com
marketplace.json · github.com