Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add wmahfoudh/okf --skill okf-validate -a claude-code
Open on GitHub

What 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-bundle against the specification.
  • Audit ./my-bundle and explain each finding with its specification section.
  • Run a strict check on ./my-bundle and return a JSON report.

How to install okf-validate

1Skills CLI (Vercel)

npx skills add wmahfoudh/okf --skill okf-validate -a claude-code

2Manually: put the files in place

~/.claude/skills/okf-validate/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/okf-validate/

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.

Similar skills

SKILL.md skills catalog →

From the same set8

okf-writer The okf-writer Claude Code subagent drafts concepts from source records under a run’s rules. It handles one part of a bulk produced with okf-produce. CX Codex ★ 105repo stars okf-runner The okf-runner Claude Code subagent runs one computation or read-only check from a brief. It returns a run record with the tool output and any error. CX Codex ★ 105repo stars okf-derivation-reader The okf-derivation-reader Claude Code subagent answers a task set using an OKF bundle. It works from the bundle alone, without task references or extra context. CX Codex ★ 105repo stars okf-faithfulness-reader The okf-faithfulness-reader Claude Code subagent checks concept claims against the passages cited in their footnotes. It flags unsupported claims, conflicting facts, and questions the sources leave open. CX Codex ★ 105repo stars okf-comparison-reader The okf-comparison-reader subagent for Claude Code, Codex, and Cursor checks task answers against references. It evaluates queries, rules, numbers, and answers stating that the bundle contains no information. CX Codex ★ 105repo stars okf-answer The okf-answer Claude Code skill answers questions using Open Knowledge Format bundles. It can also run bundle computations and save answers on request. CX Codex +1 ★ 105repo stars 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. CX Codex +1 ★ 105repo stars

Project sponsors

Companies that keep this analytics open