Using OKF Bundles with Claude Code — Complete Guide
Claude Code by Anthropic has native support for Open Knowledge Format (OKF) bundles, making it one of the best AI coding agents for loading structured knowledge. This guide shows you how to use OKF bundles with Claude Code, which bundles work best, how to create your own, and how OKF compares with Claude's native skill format.
How Claude Code Loads OKF Bundles
Claude Code can read OKF bundles directly from your filesystem. When you point Claude at a directory containing an OKF-conformant bundle, it automatically discovers the structure, reads the YAML frontmatter, and loads the knowledge into its context window. This native support means you don't need any plugins, SDKs, or special configuration.
Native OKF Support
Claude Code recognizes OKF bundles through their index.md manifest file. When Claude encounters a directory with an index.md containing valid YAML frontmatter (title, description, tags), it treats the directory as an OKF bundle and recursively indexes all markdown files, following cross-links between concept documents.
Two Loading Methods
There are two primary ways to load OKF bundles into Claude Code:
- Direct directory reference — Run
claude ./path/to/bundle/to load a specific bundle for a session - Skill directory placement — Place bundles in
~/.claude/skills/for automatic discovery and persistent availability
Step-by-Step: Using OKF Bundles with Claude Code
Step 1: Find an OKF Bundle
Browse the BundleDex directory to discover OKF bundles compatible with Claude Code. Look for bundles tagged with claude-code, claude, or bundles that mention Claude Code in their description. You can also use the BundleDex search API to find Claude Code-compatible bundles.
Step 2: Clone the Bundle Repository
Clone the bundle's GitHub repository to your local machine:
# Clone a Claude Code-compatible bundle
git clone https://github.com/iwe-org/iwe.git ~/okf-bundles/iwe
# Or clone any bundle from its repo_url
git clone https://github.com/psinetron/echoes-vault-opencode.git ~/okf-bundles/echoes-vault
# Organize bundles in a dedicated directory
mkdir -p ~/okf-bundles && cd ~/okf-bundlesStep 3: Load the Bundle in Claude Code
Point Claude Code at the bundle directory:
# Load a bundle directly
claude ~/okf-bundles/iwe
# Claude will automatically discover the bundle's structure
# and make all concepts available in its context windowStep 4: Place Bundles in Claude's Skill Directory (Optional)
For bundles you use frequently, place them in Claude Code's skill directory for automatic discovery:
# Symlink a bundle into Claude's skills directory
ln -s ~/okf-bundles/iwe ~/.claude/skills/iwe
# Or copy it directly
cp -r ~/okf-bundles/iwe ~/.claude/skills/iwe
# Now Claude Code auto-discovers this bundle on every sessionStep 5: Use the Bundle
Once loaded, you can ask Claude Code questions about the bundle's content, follow cross-links between concepts, and use the knowledge to inform your work. Claude understands the bundle's structure, frontmatter metadata, and relationship graph.
Pro tip: You can load multiple OKF bundles simultaneously. Claude Code merges knowledge from all loaded bundles, making cross-bundle connections automatically.
Creating OKF Bundles for Claude Code
Creating an OKF bundle for Claude Code follows the standard OKF creation process with some Claude-specific considerations:
Basic Structure
Every OKF bundle needs an index.md manifest and supporting concept documents:
my-claude-bundle/
├── index.md # Bundle manifest (required)
├── concepts/ # Core domain knowledge
│ ├── architecture.md
│ └── patterns.md
├── guides/ # How-to guides
│ ├── setup.md
│ └── troubleshooting.md
└── references/ # Reference documentation
└── api.mdindex.md Frontmatter
Include Claude Code-relevant tags in your frontmatter to help Claude and BundleDex categorize your bundle:
---
title: My Project Conventions
description: Coding conventions and workflow patterns for my project
tags: [claude-code, conventions, workflow, best-practices]
version: "1.0.0"
author: Your Name
okf_version: "0.1"
---Claude-Specific Optimizations
To make your bundle work optimally with Claude Code:
- Tag with
claude-code— helps Claude identify the bundle as relevant - Use clear instructions — if the bundle is a skill, include step-by-step procedures
- Include examples — Claude learns best from concrete, runnable examples
- Cross-link concepts — Claude follows markdown links to build complete understanding
- Validate conformance — use the Open Knowledge CLI to ensure your bundle is OKF-conformant
Publishing and Submitting
Push your bundle to GitHub and submit it to BundleDex. Tag it with claude-code so other Claude Code users can discover it. Claude Code can load bundles directly from GitHub repositories, so your bundle is immediately usable by anyone who clones it.
OKF vs Claude Skills
A common question is how OKF bundles compare with Claude's native skill format. Understanding the differences helps you choose the right approach for your use case.
| Aspect | OKF Bundles | Claude Skills |
|---|---|---|
| Format | Open standard (markdown + YAML) | Proprietary (Anthropic-specific) |
| Portability | Works with any agent: Claude, OpenCode, Codex, Cursor | Claude Code only |
| Discovery | BundleDex directory, GitHub, any agent | Claude's internal registry |
| Knowledge type | Reference docs, skills, conventions, datasets | Skills and behavioral instructions |
| Versioning | Git-based, semantic versioning | Claude-managed |
| License | Open source (MIT, Apache-2.0) | Proprietary |
Can OKF Bundles Be Claude Skills?
Yes. OKF bundles placed in ~/.claude/skills/ function as Claude Skills. Claude Code automatically discovers them and treats them as skill packages. This means you can create an OKF bundle once and use it with Claude Code, OpenCode, Codex, or any other agent that supports OKF — without modification.
For a detailed comparison, see our OKF vs Claude Skills guide.
Best OKF Bundles for Claude Code
These bundles are optimized for Claude Code and tagged with Claude Code compatibility. They range from coding conventions to knowledge management systems:
Open Knowledge Format for coding agents. Author, validate, lint, search, and visualize portable Markdown knowledge bundles. One gem carries the agent skill, the CLI and Ruby library, and an interactive graph. Docker and Claude Code plugin included, 100% local.
OKF-powered knowledge context for Claude Code — injects your project's knowledge base at every session
The OKF toolkit for Claude Code — author, maintain, validate & visualize Open Knowledge Format bundles. Claude Code plugin + skills.sh.
A portable Claude Code skill (/okf) to create, read, maintain & visualize Open Knowledge Format (OKF) bundles - knowledge as plain, git-versionable Markdown.
A portable Claude Code skill (/okf) to create, read, maintain & visualize Open Knowledge Format (OKF) bundles - knowledge as plain, git-versionable Markdown.
Agent-first local harness for OKF-compatible LLM Wikis.
Structured, spec-driven development workflow for AI coding agents.
Janet builds and maintains a portable LLM wiki in plain Markdown using the Open Knowledge Format (OKF). Run her directly, call her as a subagent, or add her skills to your coding agent.
Your personal universal memory for every AI agent. Switch engines. Same mind. Git-native, zero-infra, plain markdown + MCP.
Open standard for portable AI knowledge interchange — JSON-LD + Markdown dual format with W3C PROV provenance, bi-temporal tracking, entity relationships, and OKF support.
Local-first MCP memory server for AI agents, with source citations and OKF/Markdown knowledge bases.
MCP server + CLI that turns the task manager you already use into persistent agent memory for Claude Code and any MCP client. Hybrid retrieval (RRF), no vector database. Adapters: TickTick, Obsidian, Notion, GitHub, Airtable, Google, OKF, Taskmaster, Beads.
Living Docs — a AI agent skill that runs your project's documentation as a living system: constitution, ADRs, BDRs, PRDs, issues, research notes & Mermaid architecture diagrams under five no-drift governance invariants. OKF-formatted, stack-agnostic. Works with Claude Code, Cursor, Copilot, OpenCode & Pi.
Agent Wiki is a lightweight OKF-compatible knowledge layer for AI agents, turning documents, code, and project context into portable, retrievable memory.
AI SEO for WordPress — llms.txt, Markdown endpoints, FAQ + schema, 29 AI crawler controls, E-E-A-T, WebMCP and Google OKF. Makes your content readable by ChatGPT, Perplexity, Claude, Gemini and Google AI Overviews. Works alongside Yoast, Rank Math and AIOSEO. GPL-2.0. By HostMyBlog / Etica Studio.
Long-term memory for CLI agents — cross-CLI, cross-project, cross-session. OKF Wiki + MCP server, model-agnostic.
MJML knowledge for AI tooling, in two formats: a Claude skill plus a conformant Open Knowledge Format (OKF) bundle for authoring, compiling, and debugging responsive email. Same knowledge, pick your tool — plain Markdown, MIT-licensed.
MJML knowledge for AI tooling, in two formats: a Claude skill plus a conformant Open Knowledge Format (OKF) bundle for authoring, compiling, and debugging responsive email. Same knowledge, pick your tool — plain Markdown, MIT-licensed.
Memory for your coding agent — markdown project graph template: product, plans, features, bugs, specs, architecture, releases
Agent Skills–compatible procedure for authoring, reading, and validating OKF (Open Knowledge Format) v0.1 bundles — markdown + YAML frontmatter for agent-readable knowledge. Works with Claude Code, Claude API, OpenClaw.
Ready-to-fork starter for an AI-maintained knowledge base on the Open Knowledge Format (OKF) v0.1 — Markdown + YAML frontmatter, with a Claude Code skill, conformance validator, and EN/TH docs.
Self-learning, OKF-based second brain that lives in a git repo and runs across Claude, Codex, Github copilot, Antigravity, and Cursor.
Context Layering & Engineering for Agentic Resources — Persistent memory, intelligent context, and structured project management for Claude Code
Governance for AI-written project docs — verify, catch drift, keep them code-grounded, enforce in CI. Zero-dependency, OKF-compatible.
Marketing memory for your AI agent — markdown campaign graph template: positioning, launch venues, CRM, posts, mentions, experiments
Ready-to-fork starter for an AI-maintained knowledge base on the Open Knowledge Format (OKF) v0.1 — Markdown + YAML frontmatter, with a Claude Code skill, conformance validator, and EN/TH docs.
OKF conformant agent schemas for LLM-maintained wikis
An AI-first, open-source second brain: plain-markdown notes in a local vault that Claude, Cursor, and other agents read and write directly over MCP. An Obsidian alternative built for the age of agents.
LLM-maintained, fully-cited personal wiki in Open Knowledge Format — with an MCP server so an AI can search and read it.
Agent Skills–compatible procedure for authoring, reading, and validating OKF (Open Knowledge Format) v0.1 bundles — markdown + YAML frontmatter for agent-readable knowledge. Works with Claude Code, Claude API, OpenClaw.
Agent Skill teaching Claude Code and Codex to author, validate, and consume Open Knowledge Format (OKF) v0.1 bundles
CLI de scaffolding: Spec-Driven Development + Open Knowledge Format (OKF) para Claude, Codex, Cursor, Gemini, Copilot e Windsurf
A VS Code and Cursor extension for exploring Open Knowledge Format (OKF) v0.2 and Karpathy-style LLM wikis—view Markdown, YAML metadata, PDFs, links, outlines, and knowledge graphs, then hand grounded context to AI agents.
Portable context-economy kit for coding agents: a graph-derived PROJECT_MAP, an output wrapper, and curated knowledge (OKF) — so the agent stops reading source files to find things.
Persistent memory for Claude Code — save decisions, findings, and checkpoints as plain markdown so no knowledge is lost to context compaction. Built on the Open Knowledge Format (OKF), with a one-click setup wizard.
Portable, OKF-compatible company knowledge base in Markdown. Compiles to a hierarchical, scale-ready index for LLMs + an offline HTML viewer for humans — with facets, search-by-meaning, and built-in agent procedures (onboarding, dedup, capture). Works with Claude Code, Codex, Antigravity — or no agent.
Claude skill: agent-maintained OKF knowledge wikis instead of RAG
A compounding file-based knowledge wiki for AI agents (Karpathy LLM-Wiki + Google OKF), packaged as a Claude Code plugin.
Claude Code / Grok plugin: OKF Agent Graph Engineering Runtime (AGER) — multi-agent loop schema, depends on okf-plugin (okf-graph-eng)
Cross-agent Claude Code / Codex skill to author, convert, and validate Markdown in Open Knowledge Format (OKF).
Agent skill: structured, resumable domain-elicitation interviews that emit an OKF knowledge bundle (glossary, tri-temporal events, rules, context map)
OKF v0.1 knowledge bundle generator — Claude skill + OpenCode integration
Turn any website into a portable, agent-ready Open Knowledge Format (OKF) bundle — no LLM required. Crawl, sync, chat offline, and serve docs to coding agents over MCP.
Persistent memory for Claude Code — your sessions distilled into a Google OKF knowledge bundle (plain markdown you own, not a database you're locked into) and injected back at the start of every session.
Local-first developer workbench for Open Knowledge Format bundles
OMI/Obsidian memory tooling (Open Knowledge Format) for AI agents: reproduce the integration on any machine, plus a local web app to view, edit, and add memory entries.
Harness-owned reader/author for Pi-agent OKF (Open Knowledge Format) knowledge bundles
Claude Code marketplace for the nine Spillwave second-brain ContentPack plugins. Shared OKF knowledge tree for Grok Bot job functions.
LLM-maintained knowledge base (OKF + Karpathy LLM-wiki pattern) for STRT's daily That's a First Digest n8n workflow.
Generic account and relationship ContentPack plugin: clients, contacts, account plans, deliverables, commitments, renewals. Dual-host (Claude Code + Grok Build + Codex).
Generic Open Knowledge Format (OKF) project memory templates and agent skills for Claude Code and Codex.
The Filesystem Agent Workspace template family: a folder-based agent workspace, a shared context store, and a capability registry. Plain Markdown + git, agent-agnostic, no lock-in.
A lightweight way for coding agents to accumulate and reference curated Markdown knowledge — no vector DB, no pre-indexing, no custom code.
A local-first, model-agnostic system that compiles sources into durable Markdown for Claude and Codex.
Three Claude Code skills for a local, in-repo, git-tracked knowledge base built on the Open Knowledge Format (OKF): scaffold, backfill, and capture-at-session-close.
Serve + maintain an OKF (Open Knowledge Format) markdown knowledge bundle: read API + ai-wiki CLI + headless-agent curation. Apache-2.0.
Self hostable AI Chat for ingested (Claude .SKILL included) PDFs using local SLM RAG (Karpathy Wiki and OKF)
Portable scaffold for spinning up focused workspaces (batcaves) in any agentic coding tool — Claude Code, Amplifier, Cursor, Codex CLI, Amp, Cline, RooCode, Aider, Gemini CLI, Windsurf. One persona + one OKF knowledge bundle, freshness-aware.
A Claude Code plugin for reading, writing, validating, and maintaining Open Knowledge Format (OKF)
Open Knowledge Format (OKF) plugin for Claude Code — a skill, auditor agent, and session hook that keep every project's knowledge catalog current.
Personal Claude Code marketplace hosting the okf-docs plugin: an OKF v0.1 documentation bundle with a deterministic linter, hooks, commands, and a maintaining-kb skill.
Claude Code repo starter for OKF-style specs, ADRs, docs-sync hooks, stale mapping checks, generated spec drafts, and conservative ADR suggestions.
Open Knowledge Format (OKF) v0.1 toolkit — create, validate, migrate, visualize, and maintain portable, agent-readable knowledge bundles. 11 commands, zero backend, pure markdown.
Reusable Claude Code skills: accessible-comms, singleton-lock, webhookwait, okf, mermaid, pwa-push-app
OKF 기반 LLM-wiki를 Claude Code에서 자동 활성화하는 플러그인
Inbound consulting-lead ContentPack plugin: engagement types, qualification, discovery, scopes, capability matches. Dual-host (Claude Code + Grok Build + Codex).
Content and audience ContentPack plugin: articles, drafts, series, subscribers, segments, performance. Dual-host (Claude Code + Grok Build + Codex).
Open Knowledge Format tooling for LLM coding agents (Claude and Codex)
OKF semantic-layer builder + cross-platform analytics skills for Claude Code & Codex
Data Engineering Knowledge Capture (DEKC) — OKF second brain for data platforms: standard schemas, lineage, streams/jobs, medallion, semantic layer, glossary. Extends PKC + OKF. Claude / Grok / Codex / OpenCode plugin.
Agentic project management in plaintext using OKF executed by claude code agents through a native macOS app
Chief-of-staff ContentPack plugin: priorities, decisions, blockers, escalations, digests, and action items. Dual-host (Claude Code + Grok Build + Codex).
Executive job-search ContentPack plugin: job leads, roles, compensation, interview stages, offers. Dual-host (Claude Code + Grok Build + Codex).
Go-to-market ContentPack plugin: offers, positioning, messaging, ICPs, campaigns, battle cards. Dual-host (Claude Code + Grok Build + Codex).
Condensed, agent-consumable reference for deploying and operating Kimi K3 as a coding agent backend. Architecture, inference engine config (vLLM/SGLang/TokenSpeed), MXFP4, thinking-mode and tool-call patterns, benchmark profile, and a model-routing decision tree vs Claude Fable 5 / GPT-5.6 Sol / Claude Opus 4.8. Sourced from the official Kimi K3 model card.
A portable Claude Code skill that turns Claude into the librarian of an OKF-style markdown knowledge base (compile / synthesize / audit).
Turn your documents, wikis, and sources into agent-consumable knowledge — a governed lifecycle (K-DLC) that produces provenance-bearing, reviewable Open Knowledge Format bundles usable natively from Claude Code, Codex, and any MCP client.
Kennis-verzamelapp: leg notities, foto's, documenten en links vast en laat Claude ze omzetten in een Open Knowledge Format-kennisbank met kennisgraaf. Self-hosted, vanilla PHP.
A portable method for AI-maintained knowledge bases — a compounding markdown wiki (Karpathy's LLM-Wiki + Google's OKF + Anthropic's Dreaming). Spanish original included.
Local-first agent memory for multi-tool workflows. Markdown vault, session capture, compile-to-notes — OpenCode, Claude Code, Codex, Cursor. No cloud lock-in.
Shareable LLM Wiki skill kit for Obsidian-compatible agent knowledge bases
Loom turns everyday conversation with Claude Code or GitHub Copilot into a persistent, self-maintaining personal knowledge vault, formatted to the Open Knowledge Format (OKF) spec.
memvault — local knowledge engine for AI agents: capture Codex/Claude/Gemini sessions, hybrid semantic+keyword retrieval, one MCP server for every harness, interactive graph, OKF export.
News digest ContentPack plugin: news items, sources, scheduled digests, trends, follow-up candidates. Dual-host (Claude Code + Grok Build + Codex).
Local-first OKF v0.2 Obsidian memory shared by Codex and Claude Code
A suite of Claude Code plugins for adding Open Knowledge Format (OKF) support to your project
Convert Markdown files and web pages into a conformant Open Knowledge Format (OKF v0.1) bundle. Deterministic Python + optional LLM enrichment. Claude Code skill + standalone CLI.
Daily AI-news captures → Open Knowledge Format → a 383-node knowledge graph. The Claude Fable 5 storyline, assembled by community detection.
OKF-inspired, verification-first session handoff workflow for Claude Code — hand off a long session to a fresh one via a portable Markdown/YAML knowledge bundle. No Gemini/Google Cloud/paid services.
OKF graph engineering plugin for Claude Code and Grok Build — impact analysis, agent/harness graphs, progressive disclosure
Starter template for agent-driven projects: an OKF knowledge bundle, a decision register (ADRs), planning docs, and the agent working-hygiene rules that keep them from drifting.
The OKF toolkit for Claude Code — author, maintain, validate & visualize Open Knowledge Format bundles. Claude Code plugin + skills.sh.
Claude Code plugin: author, explore, validate, and visualize Google's Open Knowledge Format (OKF) v0.1 bundles.
Hands-on demo of two agent-friendly knowledge formats: Andrej Karpathy's llm-wiki pattern and Google's Open Knowledge Format (OKF) — the same Claude knowledge base organized both ways.
Project Knowledge Capture (PKC) — Claude Code + Grok Build plugin: capture meetings/experiments/decisions and materialize WikiTicket into OKF knowledge graphs
Python CLI template with uv setup, strict typing, 90% coverage, offline-safe provider stubs, and optional claude-okf-repo-kit layering.
Evidence-bound repository-to-OKF compiler using deterministic analysis and optional Codex or Claude Code enrichment
Sales pipeline ContentPack plugin: leads, opportunities, stages, next actions, objections, proposals, forecast. Dual-host (Claude Code + Grok Build + Codex).
Shared foundation for Spillwave ContentPack plugins: OKF schemas, typed edges, deterministic write helpers, and progressive-disclosure packing. Dual-host (Claude Code + Grok Build + Codex).
Public starter second brain: agent identities, packing prompts, articles workflow, fictional Northstar graph. No real client names.
Local always-on service that emails a digest when tonight's ISS pass is worth stepping outside for. Built with the claude-okf-repo-kit scaffold.
Second brain for system architecture information — reverse-engineer monorepos/multi-repos into standard OKF schemas (PKC + SAC). Plugins for Claude Code, Grok, Codex, OpenCode.
Start a new OKF / LLM-wiki knowledge vault in seconds: a Claude Code plugin (new-vault scaffolder + ingest-source skill) and a clone-able template.
Browse all 565 bundles on BundleDex, or filter by the claude-code tag to find more.
Tips for OKF + Claude Code Workflows
Use OKF-Conformant Bundles
OKF-conformant bundles follow the full specification and work reliably across all Claude Code versions. Look for the green OKF badge when choosing bundles on BundleDex. Conformant bundles have validated frontmatter, proper structure, and consistent cross-linking.
Combine Multiple Bundles
Claude Code can load multiple OKF bundles simultaneously. Create a layered knowledge setup:
- Conventions bundle — coding standards, style guides, workflow patterns
- Domain bundle — expert knowledge about your technology stack
- Project bundle — architecture docs, API references, project-specific conventions
Keep Bundles Updated
OKF bundles are version-controlled with Git. Pull the latest updates regularly to ensure Claude has the most current knowledge for your project. Consider setting up a cron job or git hook to auto-pull your key bundles:
# Auto-update bundles
for bundle in ~/okf-bundles/*/; do
(cd "$bundle" && git pull)
doneCreate Project-Specific Bundles
Create a custom OKF bundle for each project containing its architecture, conventions, API documentation, and setup instructions. Claude Code will reference it automatically when working in that directory, providing consistent, project-aware assistance.
Use GitHub Actions for Bundle Validation
If you maintain OKF bundles, set up GitHub Actions to validate them on every commit. The Open Knowledge CLI can check conformance, verify frontmatter, and test cross-link integrity automatically.
FAQ
Does Claude Code support OKF bundles?
Yes, Claude Code natively supports OKF bundles. You can point Claude at any OKF bundle directory and it will automatically discover and load the structured knowledge. No plugins, SDKs, or configuration needed. This native integration makes OKF the preferred format for packaging knowledge in Claude Code workflows.
How do I load an OKF bundle in Claude Code?
Clone the bundle's repository and run claude /path/to/bundle/ from your terminal. Claude will read the bundle's index.md, discover all concept files, and make the knowledge available in its context window. For persistent access, place bundles in ~/.claude/skills/ for automatic discovery on every session.
What's the difference between OKF and Claude Skills?
OKF is an open standard that works across any agent framework (Claude Code, OpenCode, Codex, Cursor), while Claude Skills is Anthropic's proprietary format limited to their ecosystem. However, OKF bundles placed in ~/.claude/skills/ work identically to Claude Skills. See our OKF vs Claude Skills comparison for details.
Can I create my own OKF bundle for Claude Code?
Absolutely. Create a directory of markdown files with YAML frontmatter, add an index.md as the entry point, and structure your knowledge under subdirectories. Push to GitHub, submit to BundleDex, and Claude Code users everywhere can discover and use your bundle.
What are the best OKF bundles for Claude Code?
The best bundles depend on your needs. The curated list above shows the top-rated Claude Code-compatible bundles ranked by community adoption. Claude Mega Brain and iwe are excellent starting points. Browse BundleDex and filter by the claude-code tag to explore more.
Can Claude Code use multiple OKF bundles at once?
Yes. Claude Code loads all bundles in ~/.claude/skills/ plus any bundle explicitly referenced. Combine a conventions bundle, a domain expertise bundle, and a project bundle for maximum effectiveness. Claude merges the knowledge and makes cross-bundle connections automatically.
Are OKF bundles for Claude Code free?
Yes. All OKF bundles indexed on BundleDex are open-source and free to use. They are published under permissive licenses (MIT, Apache-2.0, or similar) and hosted on public GitHub repositories. There are no paid OKF bundles in the ecosystem.