OKF — Open Knowledge Format

Visão Geral

O Open Knowledge Format (OKF) é uma spec vendor-neutral (v0.1, anunciada 12 Jun 2026 por Sam McVeety & Amir Hormati, Google Cloud) que formaliza o pattern “LLM Wiki” num formato portável e interoperável. Representa conhecimento como diretório de arquivos Markdown com YAML frontmatter. Não requer SDK — se você consegue ler um .md, consegue ler OKF.

Cada arquivo = um “conceito” (tabela, métrica, playbook, API endpoint, etc.). A estrutura é um bundle (diretório) com conceitos interligados via links Markdown padrão. O Google Cloud Knowledge Catalog ingere bundles OKF nativamente.

Quando Usar

• Criar uma base de conhecimento para agentes de IA
• Converter documentação existente para formato OKF
• Validar bundles OKF contra a especificação
• Enriquecer docs Markdown com frontmatter padronizado
• Estruturar wikis ou knowledge bases como arquivos interoperáveis
• Tornar conhecimento organizacional agent-readable
• Enviar bundles para o Knowledge Catalog via kcmd CLI/MCP

Instalação

npx skills add https://github.com/fabricioctelles/skills -s okf-open-knowledge-format

Campos do Frontmatter

Campo	Obrigatório?	Descrição
type	SIM	Tipo do conceito (texto livre: BigQuery Table, Metric, Playbook, etc.)
title	Recomendado	Nome legível para humanos
description	Recomendado	Resumo em uma frase
resource	Recomendado	URI identificando o asset subjacente
tags	Opcional	Lista YAML para categorização transversal
timestamp	Opcional	Datetime ISO 8601 da última mudança relevante

Estrutura de um Bundle

meu-bundle/
├── index.md
├── log.md
├── tables/
│   ├── index.md
│   ├── users.md
│   └── orders.md
├── metrics/
│   └── revenue.md
└── playbooks/
    └── onboarding.md

Modos de Operação

Modo	Descrição
create	Cria bundle OKF do zero a partir de descrição
convert	Converte diretório de Markdown existente para OKF conformant
validate	Verifica conformidade com a spec (3 regras)
enrich	Adiciona frontmatter faltante, schema, citations e cross-links
serve	Envia bundles pro Knowledge Catalog via kcmd push

Integração com Knowledge Catalog

O Knowledge Catalog do Google Cloud ingere OKF nativamente. A skill sabe usar o kcmd (CLI + MCP server) pra push/pull de bundles, permitindo que qualquer agente MCP-compatible acesse o catálogo.

Origem

Spec criada por Sam McVeety & Amir Hormati (Google Cloud, 12 Jun 2026). Formaliza o pattern “LLM Wiki” (gist do Karpathy) num formato interoperável. Licença Apache 2.0.

📄 Documentação completa no GitHub | 🌐 okf.md