OKF — Open Knowledge Format

Visão Geral

O Open Knowledge Format (OKF) é uma spec vendor-neutral (v0.1, Junho 2026, Google Cloud) para representar conhecimento como um diretório de arquivos Markdown com YAML frontmatter. Não requer SDK — se você consegue ler um arquivo .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.

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

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

Estrutura de um Bundle

meu-bundle/
├── tables/
│   ├── users.md
│   └── orders.md
├── metrics/
│   └── revenue.md
├── playbooks/
│   └── onboarding.md
└── README.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
enrich	Adiciona frontmatter faltante e sugere links entre conceitos

Origem

Especificação criada pelo Google Cloud (Junho 2026). Spec completa incluída como referência bundled no skill.

📄 Documentação completa no GitHub