OKF validator

Check whether your OKF files are ready for AI retrieval.

Validate the metadata and structure that help agents retrieve the right content, cite the right source, and avoid vague answers.

Free OKF tool

Convert, validate, preview, and report before an AI agent consumes it.

Validation
50/100 readinessNeeds cleanup
Frontmatter

Add a metadata block between --- markers.

Required type

Add a non-empty type field, such as type: concept.

Title

Title is available for search snippets and agent routing.

Slug

Add a slug so links and indexes stay stable.

Description

Summary context is available.

Structure

Headings create retrievable sections.

Timestamp

Add a timestamp when the concept was generated or updated.

Bundle index

Add index.md when exporting multiple OKF files.

Internal links

Add internal links when concepts reference related files.

Reserved files

Bundle includes or implies a valid index.md entry.

Duplicate concepts

No duplicate titles or slugs detected.

Citations

No external citations required for this content.

What the validator checks

The validator looks for frontmatter, title, slug, summary context, headings, and format hints. Those checks are the first quality gate for OKF files headed into search indexes, copilots, and support bots.