Open Knowledge
Authoritative agent-runtime contract for working inside an OpenKnowledge project, a...
Install
npx skills add inkeep/open-knowledge --skill open-knowledge -g -a claude-code -y- Repository
- inkeep/open-knowledge4.8k
- Category
- AI and agents
- Updated
- 4d ago
- License
- GPL-3.0
- Context cost
- Mediumabout 3,000 tokens
- Runs scripts
- No, instructions only
What it does
Authoritative agent-runtime contract for working inside an OpenKnowledge project, a markdown-CRDT knowledge base exposed over MCP. Use whenever reading, listing, searching, editing, or linting any `.md` or `.mdx` file in the project, and before any `mcp__open-knowledge*` tool call (`exec`, `search`, `write`, `edit`, `lint`, and the rest). Installed by `ok init`, so its presence means this is an OpenKnowledge project and it governs every markdown file here. Covers the read/write tool surface, grounding and linking rules, folder/template conventions, the live browser preview, and the rule that OK's MCP tools, never native file tools, handle in-scope markdown.
OpenKnowledge, agent guidance
OpenKnowledge (OK) is a markdown-CRDT collaboration platform exposed via MCP. This skill is the single source of OK agent guidance. Every rule below is a MUST unless marked otherwise. Depth lives in references/*.md, one level deep; load a reference when its task comes up.
Skill version tracks
@inkeep/open-knowledge-server.cat ~/.ok/skill-state.ymlshows what's installed.ok seedneeds@inkeep/open-knowledge>= 0.4.0; if it errorsunknown command,npm install -g @inkeep/open-knowledge.
CLI name. Commands here use Stable's
ok(open-knowledge) and~/.ok/. With OpenKnowledge Beta, useok-beta(open-knowledge-beta) and~/.ok-beta/instead;preview_url'sokOpenCommandalready names the right one.
Setup (not connected yet?). If the
mcp__open-knowledge*tools aren't available in your client, this project isn't wired up on this machine, seereferences/setup.mdfor the rung ladder (approve.mcp.json→ok startCLI → optional desktop app) and the canonical quickstart.
