{"slug": "okf-the-markdown-spec-for-humans-and-ai", "title": "OKF – the Markdown spec for humans and AI", "summary": "A new open specification called the Open Knowledge Format (OKF) has been published under the MIT license, representing knowledge as directories of markdown files with YAML frontmatter and an index.md entry point. OKF's creators say the format rests on three rules — one index per bundle, typed frontmatter (concept, howto, reference, decision, metric), and git-native history — so AI agents can parse bundles without adapters, and they cite the Google Cloud Markdown spec as its basis. The spec ships with a validate.sh script and an installable skill for Claude, Codex, and Cursor, with a zero-backend browser validator described as coming soon.", "body_md": "# The open spec for knowledge that ships.\n\nA directory of markdown files. YAML frontmatter. Three rules. That's the entire format. Your AI agents parse it without adapters, your team reviews it in git, and your docs never rot outside context again.\n\nBased on the Google Cloud Markdown spec · MIT licensed\n\n```\n├── index.md\n├── what-is-okf.md\n└── validation-rules.md\n\n---\ntype: concept\ntitle: What is OKF\n---\n\n# What is OKF\nThe Open Knowledge Format is a spec for\nrepresenting knowledge as markdown files.\n```\n\n## Why this exists\n\nMost knowledge formats ask you to learn a schema, install an SDK, and migrate your content into a proprietary store. OKF asks you to keep writing markdown. The spec exists to make three guarantees:\n\n- One index, one truth.\n- Every bundle has an index.md that lists what's inside. Agents don't guess at structure — they read it.\n- Typed frontmatter.\n- Each file declares its type (concept, howto, reference, decision, metric). Agents route to the right handler without heuristics.\n- Git-native history.\n- Diff, branch, review knowledge like code. No proprietary format holds your content hostage. Semver protects your investment.\n\n## A bundle looks like this\n\n```\n# index.md — the entry point\n---\ntitle: My Knowledge Bundle\nversion: 0.1.0\nentries:\n  - what-is-okf.md\n  - validation-rules.md\n---\n\n# My Knowledge Bundle\nEverything an AI agent needs to know about…\n```\n\n## Validate before you ship\n\nConformance is three rules, so checking it is cheap: run a shell one-liner or the OKF skill’s validate.sh today. A zero-backend browser validator is coming soon. Know your bundle is correct before your agent reads it.\n\n[How to validate →](https://okf.md/validator/)\n\n## Teach your agent the spec\n\nInstall a skill that makes Claude, Codex, or Cursor produce conformant bundles. No system prompts, no fragile instructions. The agent ships correct output because it knows the format.\n\n[Install Skill →](https://okf.md/skill/)\n\n## Ship your first bundle in two minutes.\n\nThree files. One command to validate. Zero dependencies.", "url": "https://wpnews.pro/news/okf-the-markdown-spec-for-humans-and-ai", "canonical_source": "https://okf.md/", "published_at": "2026-11-09 06:29:05+00:00", "updated_at": "2026-11-09 06:50:41.812103+00:00", "lang": "en", "topics": ["agent-protocols", "ai-agents", "developer-tools", "structured-data", "artificial-intelligence"], "entities": ["Open Knowledge Format", "OKF", "Google Cloud", "Claude", "Codex", "Cursor"], "also_reported_by": [], "alternates": {"html": "https://wpnews.pro/news/okf-the-markdown-spec-for-humans-and-ai", "markdown": "https://wpnews.pro/news/okf-the-markdown-spec-for-humans-and-ai.md", "text": "https://wpnews.pro/news/okf-the-markdown-spec-for-humans-and-ai.txt", "jsonld": "https://wpnews.pro/news/okf-the-markdown-spec-for-humans-and-ai.jsonld"}}