What is open-knowledge-discovery?

Instructions for using OpenKnowledge, a platform that turns Markdown files into a live shared knowledge base. People and coding agents can edit the same documents, with changes attributed and previewed in a browser.

Setting up OpenKnowledge in a repository, opening or previewing Markdown files, sharing projects, and checking whether the platform supports a particular capability.

It explains how to install the platform, open files, and share a project without making users learn its file and collaboration rules first.

open-knowledge-discovery — Skill for Claude Code and Codex by inkeep

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent

npx skills add inkeep/open-knowledge-skills --skill open-knowledge-discovery

Clone the repo

git clone --depth 1 https://github.com/inkeep/open-knowledge-skills

Made for: Claude Code, Codex.

Its marketplace also offers this one on its own, as the plugin discovery — /plugin install discovery after adding the marketplace above.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

README.md

[![agentmods](https://agentmods.dev/badge/skills/inkeep/open-knowledge-skills/open-knowledge-discovery/github.svg)](https://agentmods.dev/skills/inkeep/open-knowledge-skills/open-knowledge-discovery)

Your own site

<a href="https://agentmods.dev/skills/inkeep/open-knowledge-skills/open-knowledge-discovery"><img src="https://agentmods.dev/badge/skills/inkeep/open-knowledge-skills/open-knowledge-discovery/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

Your own site · 80×15

<a href="https://agentmods.dev/skills/inkeep/open-knowledge-skills/open-knowledge-discovery"><img src="https://agentmods.dev/badge/skills/inkeep/open-knowledge-skills/open-knowledge-discovery.svg" alt="Reviewed on agentmods" width="80" height="20"></a>

Per session 139 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.

When invoked 1,942 The whole file, excluding the scripts and references it only reads on demand.

Security scan B 1 finding. A grade says what 26 rules found in the file — not that it is safe. Third-party audits

Socket pass 26 Aug 2026
Snyk pass 26 Aug 2026

How audits are shown

Origin original No closer match found in the catalogue.

Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

Model	Per session	Once invoked
Fable 5.1	$0.00139	$0.01942
Opus 5.5	$0.00056	$0.00777
Sonnet 5.5	$0.00028	$0.00388
Haiku 4.5	$0.00014	$0.00194

Measured 23d ago against content hash 46dfe82a2d28, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade B, and why

open-knowledge-discovery scanned grade B with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 23d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Enumerates other installed skillsmediumAgent snooping

Other skills' SKILL.md files reveal prompts, capabilities and secrets that should be invisible to peers.

description: "Read when the user asks what OpenKnowledge is, wants to install it on a repository, wants to open or preview a single markdown file that is not part of an OpenKnowledge project, wants to share an OpenKnowle

skills/core/open-knowledge-discovery/SKILL.md · 156 lines

How it starts

The opening of the file, as written. The whole thing — 156 lines — stays where its author put it; the contents beside it link to each section on GitHub.

OpenKnowledge — what it is and how to install it

OpenKnowledge (OK) is a markdown-CRDT collaboration platform. It turns a directory of .md / .mdx files into a live, multi-writer knowledge base: agents and humans edit the same documents in real time, every change is attributed, and a browser preview renders edits as they land.

This skill covers discovery, install, and opening OpenKnowledge files — including single files that are not part of a project (see Opening a file outside a project below). It does not carry the in-project read/write runtime contract (the STOP rules for native file tools, the grounding and linking rules, the MCP routing table) — that ships separately as the project-local skill installed by ok init (see Working inside a project below).

CLI name. Commands below use Stable's ok (open-knowledge). OpenKnowledge Beta's terminal commands are ok-beta (open-knowledge-beta), with ~/.ok-beta/ in place of ~/.ok/.

Install OpenKnowledge on a repository

Run ok init from the repository root:

npx @inkeep/open-knowledge init
# or, after a global install:
npm install -g @inkeep/open-knowledge
ok init

ok init is the one setup verb. It:

scaffolds a .ok/ directory (project config — content.dir defaults to .);
wires the OpenKnowledge MCP server into the coding agents it detects on this machine — skip with --no-mcp;
installs the project-local runtime skill into each detected agent's skills dir (<agent-dir>/skills/open-knowledge/) so agents working in this repo get the full read/write contract. OK only writes into agent directories that already exist — it never creates one, so nothing appears for agents you don't use, and ok init says so when it finds none;
ensures the project has a .git/.

Re-run ok init any time to refresh wiring and skills to the installed CLI version.

An OK project travels with its repository. To share one:

Read the full file on GitHub · 156 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

23d ago Changed · +4 lines 46dfe82a2d28
2mo ago First seen · 152 lines · 139 tokens per session scan B 550e2f3614ec

Subscribe to this mod's changes

open-knowledge-discovery is a skill published in the GitHub repository inkeep/open-knowledge-skills (17 stars, last pushed 11d ago), licensed MIT. It adds 139 tokens to every session and 1,942 once invoked, about $0.0006 per session on Opus 5.5. A static security scan graded it B with 1 finding (enumerates other installed skills). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Documents Writing and docs agent-skills ai-agents mcp open-knowledge skills

open-knowledge-discovery next to 6 skills from other repositories
Mod	Type	Stars	Last push	Licence	Scan	Tokens	Works with
open-knowledge-discoveryinkeep/open-knowledge-skills	Skill	17	11d ago	MIT	B	139	Claude Code, Codex
pdfagentscope-ai/QwenPaw	Skill	37k	2d ago	Apache-2.0	A	95	Claude Code, Codex
officecli-academic-paperiOfficeAI/OfficeCLI	Skill	33k	8d ago	Apache-2.0	A	141	Claude Code, Codex
officecliiOfficeAI/OfficeCLI	Skill	33k	8d ago	Apache-2.0	A	56	Claude Code, Codex
readtw93/Waza	Skill	7.5k	5d ago	MIT	A	61	Claude Code
docx-comment-replyforyourhealth111-pixel/Vibe-Skills	Skill	3.8k	3d ago	Apache-2.0	A	39	Claude Code, Codex
huashu-md-to-pdfalchaincyf/huashu-skills	Skill	2.2k	5d ago	MIT	A	83	Claude Code, Codex

open-knowledge-discovery