okf-produce — Claude Code skill for building OKF bundles
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.
no license ★ 105 updated 2026-10-31
npx skills add wmahfoudh/okf --skill okf-produce -a claude-codeWhat okf-produce 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.
What it helps with
- 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 for the agent
- 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.
How to install okf-produce
1Skills CLI (Vercel)
npx skills add wmahfoudh/okf --skill okf-produce -a claude-code2Manually: put the files in place
~/.claude/skills/okf-produce/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/okf-produce/
1Skills CLI (Vercel)
npx skills add wmahfoudh/okf --skill okf-produce -a codex2Manually: put the files in place
.agents/skills/okf-produce/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add wmahfoudh/okf --skill okf-produce -a cursor2Manually: put the files in place
.cursor/skills/okf-produce/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install wmahfoudh/okf skills-pi/okf-produce/SKILL.md2Manually: put the files in place
.github/skills/okf-produce/SKILL.md1Skills CLI (Vercel)
npx skills add wmahfoudh/okf --skill okf-produce -a gemini-cli2Platform CLI
gemini skills install https://github.com/wmahfoudh/okf --path skills-pi/okf-produceManually: put the files in place
.devin/skills/okf-produce/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about okf-produce
How do I install okf-produce in Claude Code?
Run npx skills add wmahfoudh/okf --skill okf-produce -a claude-code. The skill file is at ~/.claude/skills/okf-produce/SKILL.md.
What does okf-produce do?
It builds an OKF bundle from source material and creates a context with source records. Later runs update both; its commands also build indexes and run checks.
What does okf-produce require?
It requires Python 3.10 or later and PyYAML.