open-knowledge-discovery Skill for Claude Code: What It Does and How to Install It

Tells Claude what OpenKnowledge is and how to install it on a repo, share a project and open a markdown file in a live preview.

Installs: 15.1K; on skills.sh
Stars: 15; on GitHub
Updated: Oct 2026; last repo commit

This skill is a guide to OpenKnowledge (OK), Inkeep's markdown collaboration platform. It tells Claude how to run ok init on a repo, share a project, open a single markdown file in a live preview and use ok cowork for Claude Desktop.

It does not read or write inside an OK project, which is the job of a separate skill that ok init installs. It needs the OK command line tool, run through npx or installed with npm.

Good for

Teams setting up OpenKnowledge on a repository and sharing it
Anyone who wants a live preview of one markdown file
Claude Desktop users who want to add the OpenKnowledge skill

Install open-knowledge-discovery

Claude Code

Copy this prompt.

Install the open-knowledge-discovery skill in Claude Code. Run this command:

/plugin marketplace add inkeep/open-knowledge-skills
/plugin install discovery@open-knowledge-skills

Then check that it loaded and tell me how to use it.

2
Paste it into Claude Code. It shows the change and asks before running it.

The README's own install command, /plugin install open-knowledge@open-knowledge-skills, installs the platform skill, not this one. The discovery plugin in marketplace.json lists only this skill's folder, and the repo tree has no hooks or MCP config files. The skill tells Claude to run npx and ok commands, so there is no Claude app upload route. Claude Desktop users: SKILL.md says ok cowork builds openknowledge.skill, the OpenKnowledge runtime skill, for upload.

Built from the package data we hold. Not yet tested by us.

What's in the skill

When it loads

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 OpenKnowledge project with collaborators, asks whether OpenKnowledge supports a particular capability, or asks how `ok init` / `ok cowork` / OK Desktop set up a project. Do NOT load to perform OpenKnowledge reads/writes — the runtime guidance for editing markdown inside an initialized OK project ships as a separate project-local skill installed into each detected agent's skills dir (for example `.claude/skills/open-knowledge/`) whenever `ok init` runs.

Sections in SKILL.md

Install OpenKnowledge on a repository
Share an OpenKnowledge project with collaborators
ok cowork — Claude Chat & Cowork
OK Desktop
Opening a file outside a project
What else OK does
Working inside a project — use the project-local skill, not this one
Learn more

Key facts

Author: Inkeep (SKILL.md metadata; vendor's own repo, published by Open Knowledge)
License: MIT (LICENSE file and README)
Installs on skills.sh: 15,126 (Nov 2, 2026)
GitHub stars: 15 for the whole repo (Nov 2, 2026)
Last repo commit: Oct 27, 2026
Audits on skills.sh: Gen Agent Trust Hub: pass, Socket: pass, Snyk: pass
What it includes: 1 file: SKILL.md (from the repo tree)
Needs: Node.js for the npx route; the frontmatter says no MCP server is required
Part of: The discovery plugin in the repo marketplace, which lists this skill only

What it includes

npx @inkeep/open-knowledge init, or install globally and run ok init
Scaffolds a .ok/ folder, wires the OpenKnowledge MCP server into detected coding agents (skip with --no-mcp), installs a project-local skill and ensures a .git folder.
Try: “Set up OpenKnowledge on this repo”
Runs code · Install on a repository
Commit .ok/ and the project skills; collaborators run ok init once
Then ok start, or OK Desktop, opens the editor and preview.
Write · Share a project
Builds openknowledge.skill and opens Claude Desktop for upload
You upload it in Customize, Skills, then Upload skill.
Runs code · ok cowork
Standalone macOS app that bundles its own CLI
SKILL.md says it keeps MCP wiring and skills current on every launch. Download the DMG from the releases page.
OK Desktop
preview_url MCP tool with a file path, or ok open /abs/path/file.md
Uses a throwaway session in the OS temp folder and writes no .ok/ into your repo. It tells Claude never to run ok init just to view a file.
Try: “Open notes/plan.md in a live preview”
Runs code · Open a file outside a project
Read the OK docs and source instead of guessing
SKILL.md says capabilities change between releases. ok --help lists the commands.
Network · Look up capabilities

From the official docs

Permissions

Medium risk

This skill leads Claude to run ok init, which changes your repo and writes MCP and skill setup into the coding agents on your machine. Run it on a repo you are ready to change, and use --no-mcp if you do not want the MCP wiring.

What it can do

Read your data
Create and change things
Delete things
Read-only mode

Watch out for

ok init changes your repo and agent setup
SKILL.md says it scaffolds .ok/, wires the MCP server into detected coding agents, installs a project-local skill into agent folders that already exist, and ensures the project has a .git folder. Skip the MCP step with --no-mcp. github.com
It runs npx and a global npm install
The install steps use npx @inkeep/open-knowledge init, or npm install -g @inkeep/open-knowledge then ok init. That downloads and runs a package from npm. github.com
Opening a file may launch a browser or app
SKILL.md says ok open opens the Desktop app if installed, else a browser. It tells Claude to open a browser only when it has a viewing surface. github.com
It warns against ok init just to view a file
SKILL.md says opening one file needs no project and runs in a temp session, and that your repo is never touched. github.com

Security advisories

No published security advisories as of Nov 2, 2026.

Technical details

Turning on read-only	SKILL.md describes no read-only mode.
Talks to	npm registry (@inkeep/open-knowledge). openknowledge.ai (docs it points to). github.com/inkeep (source and releases)
Sign-in and keys	SKILL.md names no account, key or login for these steps.
Scopes	Runs npx @inkeep/open-knowledge or ok commands in your shell ok init writes a .ok/ folder and a project skill into the repo and adds MCP wiring for detected coding agents ok open can launch the OK Desktop app or a browser

Questions

What does open-knowledge-discovery do?

It tells Claude what OpenKnowledge is and how to set it up. That covers ok init on a repo, sharing a project with collaborators, ok cowork for Claude Desktop, OK Desktop, and opening one markdown file in a preview.

How do I install it?

Use the install box at the top of this page. The repo README documents a plugin command for the platform skill; the box has the plugin command that installs only this discovery skill.

How is it different from the open-knowledge skill?

This skill covers discovery, install and opening files. SKILL.md says the in-project read and write rules live in a separate project-local skill that ok init installs, and the README lists open-knowledge as the runtime contract for an OK project.

Is it an official OpenKnowledge skill?

Yes. It lives in inkeep/open-knowledge-skills, which the README describes as skills published by Open Knowledge, and its metadata names Inkeep as author.

Is it safe?

It leads Claude to run ok init, which writes a .ok/ folder and a project skill into your repo and adds MCP wiring to the coding agents it finds. It also runs npx or a global npm install. Skip the MCP step with --no-mcp, and use it on a repo you are ready to change.

Does it need an MCP server or API key?

The frontmatter says no MCP server is required and describes the skill as discovery and install guidance. When the OpenKnowledge MCP server is wired in, Claude uses its preview_url tool to open a file; otherwise it uses ok open.

Can I open a markdown file without running ok init?

Yes. SKILL.md says OpenKnowledge can open a single file outside a project in a throwaway session in the OS temp folder, with no .ok/ written into your repo.

Does it work in Claude Desktop?

SKILL.md says ok init wiring does not reach Claude Chat or Cowork. Run ok cowork to build openknowledge.skill, then upload it under Customize, Skills.

Information

updated Nov 2, 2026

Repository: inkeep/open-knowledge-skills
Folder: skills/core/open-knowledge-discovery

inkeep/open-knowledge-skills skills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 3

open-knowledge-discovery SKILL.md · github.com
README · github.com
marketplace.json · github.com