Open Knowledge Discovery

Explica OpenKnowledge, la configuración de ok init, el uso compartido de repositorios y la apertura de archivos markdown sueltos

Por inkeep · inkeep/open-knowledge

Funciona con configuración ★ 7.6/10

Open Knowledge Discovery — Explica OpenKnowledge, la configuración de ok init, el uso compartido de repositorios y la apertura de archivos markdown sueltos

Qué hace

Guía de descubrimiento e instalación para OpenKnowledge (OK), la plataforma de colaboración markdown-CRDT de Inkeep: qué es, cómo `ok init` estructura `.ok/` y conecta el servidor MCP más las habilidades del editor, cómo compartir un proyecto a través de su repositorio git, qué hacen `ok cowork` y OK Desktop, y cómo abrir un solo archivo markdown fuera de cualquier proyecto. Se activa cuando alguien pregunta qué es OpenKnowledge, quiere instalarlo en un repositorio o pregunta cómo compartir un proyecto OK con colaboradores. Deliberadamente no incluye el contrato de lectura/escritura en el proyecto, que se envía como una habilidad local de proyecto separada instalada por `ok init`.

Informe de la prueba

Se obtuvo SKILL.md en bruto (HTTP 200, 134 líneas) y se verificaron sus afirmaciones contra la fuente del repositorio en lugar de confiar en ellas: `packages/cli/src/commands/init.ts` documenta "Scaffolds `.ok/`" más `--no-mcp` / `--skills discovery`, `cowork.ts` coincide con la redacción exacta de Customize → Skills → + → Create skill → Upload skill, y `get-preview-url.ts` realmente expone el parámetro `file` para rutas absolutas fuera de un proyecto, todo tal como está escrito. npm `@inkeep/open-knowledge` devuelve 200 con la versión más reciente 0.35.0 (coincidiendo con la versión frontmatter de la habilidad) y los binarios `ok`/`open-knowledge`; `packages/server/src/skill-bundles.ts` muestra que `ok init` instala forzosamente este paquete globalmente para el usuario como `open-knowledge-discovery`. Para la salida, respondí "add OpenKnowledge to an existing repo and share it with two collaborators" dos veces: la línea base adivinó el nombre del paquete con incertidumbre declarada y no tenía nada sobre `--no-mcp`, la habilidad local del proyecto, `ok cowork`, `ok start` o `preview_url`; la respuesta de la habilidad los nombró a todos correctamente. Dos lagunas reales: `@inkeep/open-knowledge-desktop` devuelve 404 en npm (los DMG existen en la página de lanzamientos), y la sección de compartir dice "commit `.ok/`" sin mencionar que `ok init` puede poner el proyecto en modo solo local a través de `.git/info/exclude`, donde ese commit no hace nada silenciosamente hasta que se ejecuta `ok config-sharing share`.

Probado el: 2026-07-21 · Claude Code 2.x (agent harness)

Instalación

git clone --depth 1 https://github.com/inkeep/open-knowledge.git /tmp/open-knowledge-discovery-src
mkdir -p ~/.claude/skills
cp -R /tmp/open-knowledge-discovery-src/packages/server/assets/skills/discovery ~/.claude/skills/open-knowledge-discovery
# Or let the CLI place the same skill: npx @inkeep/open-knowledge init
# Acting on its advice needs the `ok` CLI: npm i -g @inkeep/open-knowledge (bins: ok, open-knowledge)

Comandos y prompts de ejemplo

/open-knowledge-discoveryExplica OpenKnowledge, la configuración de ok init, el uso compartido de repositorios y la apertura de archivos markdown sueltos

Los skills se activan con peticiones en lenguaje natural, sin comandos que memorizar. Tras instalarlo, prompts como estos lo activan (en inglés):

What is OpenKnowledge and how do I install it
Set up ok init on this repository
Share this OpenKnowledge project with my team

Informe completo →