okf-validate — Claude Code skill for OKF checks
The okf-validate Claude Code skill checks an Open Knowledge Format (OKF) bundle against version 0.2 of its specification and explains each finding. It runs when a bundle is reviewed or after a producer creates or updates one.
no license ★ 105 updated 2026-10-31
npx skills add wmahfoudh/okf --skill okf-validate -a claude-codeWhat okf-validate does
okf-validate reads an OKF bundle directory and compares its contents with SPEC.md, then reports findings with references to specification sections. The checks are tied to individual rules, with their identifiers listed in CHECKS.md. It does not change the bundle.
Python 3.10 or later and PyYAML are required. Pass the bundle root, which contains index.md; options include --strict, --json, --output FILE and --quiet. Findings use error, warning and info levels, with exit codes reflecting the result. The check does not decide whether a concept is outdated, and it does not run computations, executors or attesters; it checks whether they are named and found.
What it helps with
- check an OKF bundle against its specification
- spot issues in frontmatter and index files
- find broken source references and log entries
- inspect trust fields and attested computation references
Example prompts for the agent
- Check the OKF bundle in
./my-bundleagainst the specification. - Audit
./my-bundleand explain each finding with its specification section. - Run a strict check on
./my-bundleand return a JSON report.
How to install okf-validate
1Skills CLI (Vercel)
npx skills add wmahfoudh/okf --skill okf-validate -a claude-code2Manually: put the files in place
~/.claude/skills/okf-validate/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/okf-validate/
1Skills CLI (Vercel)
npx skills add wmahfoudh/okf --skill okf-validate -a codex2Manually: put the files in place
.agents/skills/okf-validate/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add wmahfoudh/okf --skill okf-validate -a cursor2Manually: put the files in place
.cursor/skills/okf-validate/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install wmahfoudh/okf skills-pi/okf-validate/SKILL.md2Manually: put the files in place
.github/skills/okf-validate/SKILL.md1Skills CLI (Vercel)
npx skills add wmahfoudh/okf --skill okf-validate -a gemini-cli2Platform CLI
gemini skills install https://github.com/wmahfoudh/okf --path skills-pi/okf-validateManually: put the files in place
.devin/skills/okf-validate/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-validate
How do I install okf-validate in Claude Code?
Run npx skills add wmahfoudh/okf --skill okf-validate -a claude-code. The skill file is located at ~/.claude/skills/okf-validate/SKILL.md.
What does okf-validate do?
It checks an OKF bundle against version 0.2 of the specification and reports findings with section references. It leaves bundle files unchanged.
What does okf-validate require?
It requires Python 3.10 or later and PyYAML.