# okf

okf writes and validates Google Open Knowledge Format v0.1 bundles — a folder of Markdown atoms with YAML frontmatter any agent can read.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 127 installs · ★ 61 repo stars
- Author: akillness
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/akillness/jeo-skills/tree/HEAD/.agent-skills/okf/SKILL.md
- Updated: 2026-11-19
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/akillness-okf

## What it does

This skill gives an agent a routine for producing and reading Google Open Knowledge Format v0.1 bundles. A bundle is a directory of Markdown files, one file per piece of knowledge, so the whole folder can be tarred, committed to git or mounted for another agent.

Three frontmatter keys are required — `type`, `title`, `description` — while `resource`, `tags` and `timestamp` stay optional. The body follows loose sections: overview, schema, examples, joins and citations. Files are reached through `Read`, `Write`, `Edit`, `Grep`, `Glob`, `Bash` and `WebFetch`; nothing has to run, since the format is text.

Work tied to OKF v0.2 or to a Go CLI/MCP memory service sits outside this skill and belongs to `okf-agent-memory`. Raw page capture goes to `llm-wiki`, Obsidian vault automation to `obsidian`, and scraping pages into documents to `scrapling`.

## Requirements
- Works with: Obsidian

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add akillness/jeo-skills --skill okf -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/okf/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/okf/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add akillness/jeo-skills --skill okf -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/okf/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add akillness/jeo-skills --skill okf -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/okf/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install akillness/jeo-skills .agent-skills/okf/SKILL.md
```

2. **Manually: put the files in place**
- File: `.github/skills/okf/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add akillness/jeo-skills --skill okf -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/akillness/jeo-skills --path .agent-skills/okf
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/okf/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add akillness/jeo-skills --skill okf -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/akillness/jeo-skills/tree/HEAD/.agent-skills/okf/SKILL.md

## When to use it
- build a knowledge base out of Markdown files with YAML headers
- check that every atom has `type`, `title` and `description` filled in
- cross-link atoms into a graph rather than a folder tree
- share one table schema across several agents
- ship documentation as a tarball or git repo

## Example prompts
- Bootstrap an OKF v0.1 bundle under `knowledge/` with a table atom for `orders`.
- Validate the frontmatter in `knowledge/metrics/wau.md` against the OKF schema.
- Turn this runbook into a `Runbook` knowledge atom and link it to the related tables.

## Similar
- [okf-knowledge-base](https://affpapa.org/en/nevibecode/skills/okf-knowledge-base.md) — skill · 9400 installs
- [okf-open-knowledge-format](https://affpapa.org/en/nevibecode/skills/okf-open-knowledge-format.md) — skill · ★ 141 repo stars
- [memory-okf](https://affpapa.org/en/nevibecode/skills/memory-okf.md) — skill · 305 installs
- [okf-produce](https://affpapa.org/en/nevibecode/skills/okf-produce.md) — skill · ★ 105 repo stars
- [wiki-ingest](https://affpapa.org/en/nevibecode/skills/wiki-ingest.md) — skill · 3700 installs
- [okf-mcp](https://affpapa.org/en/nevibecode/mcp/okf-mcp.md) — MCP server · ★ 8 repo stars

## Other versions with the same name
- [okf · scaccogatto](https://affpapa.org/en/nevibecode/skills/okf.md) — 1200 installs

From the same set: [akillness/jeo-skills](https://affpapa.org/en/nevibecode/by/akillness/jeo-skills.md) — 99 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
