Open Knowledge Format (OKF)
Especificación abierta de Google Cloud para empaquetar conocimiento como un directorio de markdown con frontmatter YAML, legible por agentes.
resource: https://github.com/GoogleCloudPlatform/knowledge-catalog/blob/main/okf/SPEC.md
El Open Knowledge Format (OKF) es una especificación abierta publicada por Google Cloud el 12 de junio de 2026 bajo licencia Apache 2.0. Define cómo empaquetar conocimiento organizativo —esquemas de bases de datos, definiciones de métricas, descripciones de API, runbooks— como un directorio de archivos markdown con frontmatter YAML.1
Su propósito es que una wiki escrita por un productor pueda ser consumida por agentes de otro sin traducción intermedia. No hay SDK obligatorio, ni runtime, ni esquema de compresión.
Qué exige la versión 0.1
La superficie de la especificación es deliberadamente mínima. El único campo
obligatorio del frontmatter es type: una cadena corta que identifica el tipo
de concepto, que los consumidores usan para enrutar, filtrar y presentar.
Recomendados:
| Campo | Significado |
|---|---|
title | Nombre legible para mostrar |
description | Resumen de una sola frase |
resource | URI que identifica el activo subyacente |
tags | Lista YAML de cadenas de categorización |
Opcional: timestamp, en ISO 8601, que registra el último cambio significativo
del contenido. Se permiten pares clave/valor definidos por el productor.
Estructura del directorio
No se impone jerarquía más allá de dos nombres reservados: index.md (listado
del directorio) y log.md (historial de actualizaciones). El identificador de
un concepto se deriva de su ruta sin la extensión .md.
Enlaces y citas
Se usan enlaces markdown estándar en dos formas: absolutos relativos a la
raíz del bundle (empiezan por /) y relativos. Un enlace de A a B afirma
una relación, pero v0.1 no codifica el tipo de relación en metadatos: se
expresa en la prosa.
Las fuentes externas van en una sección del cuerpo titulada # Citations. La
atribución por afirmación concreta usa notas al pie de markdown.
Conformidad
Un bundle es conforme si todo archivo .md no reservado contiene frontmatter
YAML parseable con un campo type no vacío. Los consumidores deben tolerar
campos opcionales ausentes y enlaces cruzados rotos sin rechazar el bundle
entero — un criterio de diseño deliberadamente permisivo.
Relación con el patrón previo
OKF formaliza el patrón descrito en Wiki LLM de Karpathy, convirtiendo una práctica personal en una especificación portable. La propia documentación admite que v0.1 es un punto de partida y no un estándar cerrado.
Qué resuelve y qué no
OKF describe qué sabe un agente. No dice qué puede hacer —eso lo define un MCP— ni cómo debe ejecutar un procedimiento —eso son los Agent Skills—. Son tres capas complementarias, no alternativas, y las tres apuestan por lo mismo: markdown en git, legible por personas y por agentes. Ver capacidades de los agentes.
En una empresa, un bundle OKF es la forma más barata de que el conocimiento sobreviva a quien lo tenía —conocimiento y documentación— y el equivalente, a nivel de dominio, de lo que la data foundation es a nivel de dato: ver seguridad y gobernanza.
Citations
Especificación oficial de OKF v0.1 en el repositorio GoogleCloudPlatform/knowledge-catalog. Anuncio en el blog de Google Cloud sobre cómo OKF mejora el intercambio de datos.
Footnotes
-
GoogleCloudPlatform/knowledge-catalog, archivookf/SPEC.md. ↩