# okf-produce

The okf-produce Claude Code skill turns readable source material into an Open Knowledge Format (OKF) bundle and records its context. It activates for requests to create or update a knowledge base, even when OKF is not named.

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

## What it does

The skill converts material the model can read into an OKF bundle, with a separate context describing its sources. Inputs can include document and data folders, databases, existing knowledge bases, individual files, or messages. Later runs update the bundle and context.

The model reviews the material and writes the content; commands inventory files, create source records and indexes, check text, and calculate metrics. The `okf-validate` validator checks the bundle and context against the OKF 0.2 specification. Python 3.10 or later and PyYAML are required.

## Install

### Claude Code (native platform)

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

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

### Codex

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

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

### Cursor

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

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install wmahfoudh/okf skills-pi/okf-produce/SKILL.md
```

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

### Gemini CLI

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

2. **Platform CLI**
```bash
gemini skills install https://github.com/wmahfoudh/okf --path skills-pi/okf-produce
```

### Windsurf (Devin Desktop)

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

### 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/wmahfoudh/okf/tree/HEAD/skills-pi/okf-produce/SKILL.md

## When to use it
- build an OKF bundle from a document folder
- convert an existing knowledge base to OKF
- update a bundle after source files change
- record where the source material came from

## Example prompts
- Create an OKF bundle from this document folder and record its sources.
- Convert this knowledge base to OKF.
- Update the OKF bundle using these new files.

## Similar
- [okf-open-knowledge-format](https://affpapa.org/en/nevibecode/skills/okf-open-knowledge-format.md) — skill · ★ 141 repo stars
- [okf-knowledge-base](https://affpapa.org/en/nevibecode/skills/okf-knowledge-base.md) — skill · 9400 installs
- [okf](https://affpapa.org/en/nevibecode/skills/akillness-okf.md) — skill · 127 installs
- [memory-okf](https://affpapa.org/en/nevibecode/skills/memory-okf.md) — skill · 305 installs
- [okf-mcp](https://affpapa.org/en/nevibecode/mcp/okf-mcp.md) — MCP server · ★ 8 repo stars
- [kb-query](https://affpapa.org/en/nevibecode/skills/kb-query.md) — skill · ★ 45 repo stars

From the same set: [wmahfoudh/okf](https://affpapa.org/en/nevibecode/by/wmahfoudh/okf.md) — 8 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
