How do I install the Okf Validate skill?

Run npx skillmds@latest add spillwavesolutions/okf-validate in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Okf Validate safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Okf Validate?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Okf Validate free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Okf Validate?

spillwavesolutions (@spillwavesolutions) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Okf Validate by spillwavesolutions — Agent Skill

Name: Okf Validate
Author: spillwavesolutions

Okf Validate

Validate OKF v0.2 conformance and graph quality — orphans, connectivity, staleness, unverified high-impact nodes, broken links, missing frontmatter. Use when checking bundle health, before commits/PRs, after bulk edits, or when the user asks if the OKF graph is valid.

File contents

OKF Validate

Goal

Confirm the bundle is structurally sound (OKF-oriented conventions) and graph-quality healthy for engineering use.

Checks

Conformance (structural)

Root index.md present; prefer okf_version: "0.2"
Concept files use YAML frontmatter starting with ---
Required-ish fields: type, title (warn if missing on non-index files)
log.md present (warn if missing)

Graph quality

Broken Markdown links to missing .md targets (error)
Orphan concepts (info/warn)
Unverified high-impact nodes (x-impact: high from the owning plugin’s schema, verified: false) (warn). Isolated, this plugin declares no high-impact types.
Stale nodes past stale_after (warn)

Process

Resolve bundle path (argument, .okf/, sample-okf/, or user path).

Run tools:

okf validate <bundle>     # preferred when installed
# fallback:
python3 "${CLAUDE_PLUGIN_ROOT}/scripts/okf-graph.py" validate <bundle>
python3 "${CLAUDE_PLUGIN_ROOT}/scripts/okf-graph.py" orphans <bundle>

Optionally spot-check a sample of high-degree nodes for body quality (not just links).
Emit a pass/fail summary with issue table.

Output format

# Validation: <bundle>

**Result:** PASS | FAIL (N errors, M warnings)

| Severity | Path | Message |
|----------|------|---------|
| error | ... | ... |

## Graph stats
- Concepts: N
- Orphans: K
- Unverified high-impact: J

Rules

Deterministic tools first; LLM judgment only for qualitative notes.
Do not modify files unless the user asks to fix issues (then hand off to okf-maintain / okf-author).
Exit guidance: FAIL if any broken links or missing root index; otherwise PASS with warnings.

Done when

Clear PASS/FAIL and actionable issue list

---name: okf-validatedescription: Validate OKF v0.2 conformance and graph quality — orphans, connectivity, staleness, unverified high-impact nodes, broken links, missing frontmatter. Use when checking bundle health, before commits/PRs, after bulk edits, or when the user asks if the OKF graph is valid.---# OKF Validate## GoalConfirm the bundle is structurally sound (OKF-oriented conventions) and graph-quality healthy for engineering use.## Checks### Conformance (structural)- Root `index.md` present; prefer `okf_version: "0.2"`- Concept files use YAML frontmatter starting with `---`- Required-ish fields: `type`, `title` (warn if missing on non-index files)- `log.md` present (warn if missing)### Graph quality- Broken Markdown links to missing `.md` targets (error)- Orphan concepts (info/warn)- Unverified high-impact nodes (`x-impact: high` from the owning plugin’s schema, `verified: false`) (warn). Isolated, this plugin declares no high-impact types.- Stale nodes past `stale_after` (warn)## Process1. Resolve bundle path (argument, `.okf/`, `sample-okf/`, or user path).2. Run tools: ```bash okf validate <bundle> # preferred when installed # fallback: python3 "${CLAUDE_PLUGIN_ROOT}/scripts/okf-graph.py" validate <bundle> python3 "${CLAUDE_PLUGIN_ROOT}/scripts/okf-graph.py" orphans <bundle> ```3. Optionally spot-check a sample of high-degree nodes for body quality (not just links).4. Emit a pass/fail summary with issue table.## Output format```markdown# Validation: <bundle>**Result:** PASS | FAIL (N errors, M warnings)| Severity | Path | Message ||----------|------|---------|| error | ... | ... |## Graph stats- Concepts: N- Orphans: K- Unverified high-impact: J```## Rules- Deterministic tools first; LLM judgment only for qualitative notes.- Do not modify files unless the user asks to fix issues (then hand off to `okf-maintain` / `okf-author`).- Exit guidance: FAIL if any broken links or missing root index; otherwise PASS with warnings.## Done when- Clear PASS/FAIL and actionable issue list

Frequently asked questions