open-knowledge
open-knowledge is a skill in inkeep/open-knowledge, last changed 27 Oct 2026. It can run shell commands, reach the network and name web addresses — read the findings before installing. Our pattern check flagged nothing at commit c7ee9e9 on 27 Oct 2026.
Pattern check: nothing flagged · commit c7ee9e9 · 27 Oct 2026
InstallAuthoritative 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.
- Licence
- GPL 3.0
- Repo stars
- 4.7k
- Folder last changed
- 27 Oct 2026 (opens in a new tab)
- Publisher
- inkeep
- Files
- 17 files
- Checked
- c7ee9e9 (opens in a new tab) · 27 Oct 2026
Install
Each tab says whether it installs commit c7ee9e9, the one we checked, or the latest version.
No tab for your agent? Use Any agent for OpenCode, Goose, Windsurf (Devin Desktop), Zed, Roo Code, Factory Droid, Junie, Amp and Antigravity, and Claude Code for Cline. Kiro needs the folder copied by hand.
Pinned to commit c7ee9e9, the one we checked.
From your project's root folder:
tmp="$(mktemp -d)" &&
git clone -q --depth 1 --filter=blob:none --no-checkout https://github.com/inkeep/open-knowledge.git "$tmp" &&
git -C "$tmp" fetch -q --depth 1 origin c7ee9e9dcc2d0922fddf60e53d3540119332e682 &&
git -C "$tmp" sparse-checkout set -- packages/server/assets/skills/project &&
git -C "$tmp" checkout -q c7ee9e9dcc2d0922fddf60e53d3540119332e682 &&
mkdir -p .claude/skills &&
mkdir .claude/skills/open-knowledge &&
cp -R "$tmp"/packages/server/assets/skills/project/. .claude/skills/open-knowledge/ &&
rm -rf "$tmp"If Claude Code was already running and this created the skills folder, run /reload-skills.
Pinned to commit c7ee9e9, the one we checked.
Skills in the Claude apps belong to your account rather than to a project.
Make open-knowledge.zip, with the skill folder at the top level:
tmp="$(mktemp -d)" &&
git clone -q --depth 1 --filter=blob:none --no-checkout https://github.com/inkeep/open-knowledge.git "$tmp" &&
git -C "$tmp" fetch -q --depth 1 origin c7ee9e9dcc2d0922fddf60e53d3540119332e682 &&
git -C "$tmp" sparse-checkout set -- packages/server/assets/skills/project &&
git -C "$tmp" checkout -q c7ee9e9dcc2d0922fddf60e53d3540119332e682 &&
out="$(mktemp -d)" &&
cp -R "$tmp"/packages/server/assets/skills/project "$out"/open-knowledge &&
(cd "$out" && zip -qr - open-knowledge) > open-knowledge.zip &&
rm -rf "$tmp" "$out"In Claude, open Customize > Skills, select +, then + Create skill > Upload a skill, and choose open-knowledge.zip.
On Free, Pro and Max plans, turn on Code execution and file creation (Create and edit files in newer settings) under Settings > Capabilities.
Pinned to commit c7ee9e9, the one we checked.
From your project's root folder:
tmp="$(mktemp -d)" &&
git clone -q --depth 1 --filter=blob:none --no-checkout https://github.com/inkeep/open-knowledge.git "$tmp" &&
git -C "$tmp" fetch -q --depth 1 origin c7ee9e9dcc2d0922fddf60e53d3540119332e682 &&
git -C "$tmp" sparse-checkout set -- packages/server/assets/skills/project &&
git -C "$tmp" checkout -q c7ee9e9dcc2d0922fddf60e53d3540119332e682 &&
mkdir -p .agents/skills &&
mkdir .agents/skills/open-knowledge &&
cp -R "$tmp"/packages/server/assets/skills/project/. .agents/skills/open-knowledge/ &&
rm -rf "$tmp"Codex picks up new skills on its own; restart it if this one does not appear.
Pinned to commit c7ee9e9, the one we checked.
From your project's root folder:
tmp="$(mktemp -d)" &&
git clone -q --depth 1 --filter=blob:none --no-checkout https://github.com/inkeep/open-knowledge.git "$tmp" &&
git -C "$tmp" fetch -q --depth 1 origin c7ee9e9dcc2d0922fddf60e53d3540119332e682 &&
git -C "$tmp" sparse-checkout set -- packages/server/assets/skills/project &&
git -C "$tmp" checkout -q c7ee9e9dcc2d0922fddf60e53d3540119332e682 &&
mkdir -p .cursor/skills &&
mkdir .cursor/skills/open-knowledge &&
cp -R "$tmp"/packages/server/assets/skills/project/. .cursor/skills/open-knowledge/ &&
rm -rf "$tmp"Pinned to commit c7ee9e9, the one we checked.
From your project's root folder:
tmp="$(mktemp -d)" &&
git clone -q --depth 1 --filter=blob:none --no-checkout https://github.com/inkeep/open-knowledge.git "$tmp" &&
git -C "$tmp" fetch -q --depth 1 origin c7ee9e9dcc2d0922fddf60e53d3540119332e682 &&
git -C "$tmp" sparse-checkout set -- packages/server/assets/skills/project &&
git -C "$tmp" checkout -q c7ee9e9dcc2d0922fddf60e53d3540119332e682 &&
mkdir -p .github/skills &&
mkdir .github/skills/open-knowledge &&
cp -R "$tmp"/packages/server/assets/skills/project/. .github/skills/open-knowledge/ &&
rm -rf "$tmp"In a running Copilot CLI session, run /skills reload.
Or install it with gh skill, which also installs the commit we checked. Needs GitHub CLI 2.90 or later.
gh skill install inkeep/open-knowledge packages/server/assets/skills/project/SKILL.md@c7ee9e9dcc2d0922fddf60e53d3540119332e682 --agent github-copilot --scope projectPinned to commit c7ee9e9, the one we checked.
From your project's root folder:
tmp="$(mktemp -d)" &&
git clone -q --depth 1 --filter=blob:none --no-checkout https://github.com/inkeep/open-knowledge.git "$tmp" &&
git -C "$tmp" fetch -q --depth 1 origin c7ee9e9dcc2d0922fddf60e53d3540119332e682 &&
git -C "$tmp" sparse-checkout set -- packages/server/assets/skills/project &&
git -C "$tmp" checkout -q c7ee9e9dcc2d0922fddf60e53d3540119332e682 &&
mkdir -p .gemini/skills &&
mkdir .gemini/skills/open-knowledge &&
cp -R "$tmp"/packages/server/assets/skills/project/. .gemini/skills/open-knowledge/ &&
rm -rf "$tmp"In a running session, run /skills reload.
Or use Gemini CLI’s own installer. Installs the latest version, not the one we checked.
gemini skills install https://github.com/inkeep/open-knowledge.git --path packages/server/assets/skills/project --scope workspacePinned to commit c7ee9e9, the one we checked.
Codex, Cursor, Copilot, VS Code, Gemini CLI, OpenCode, Goose, Amp and Zed all read .agents/skills; Claude Code and Kiro list only their own folders.
From your project's root folder:
tmp="$(mktemp -d)" &&
git clone -q --depth 1 --filter=blob:none --no-checkout https://github.com/inkeep/open-knowledge.git "$tmp" &&
git -C "$tmp" fetch -q --depth 1 origin c7ee9e9dcc2d0922fddf60e53d3540119332e682 &&
git -C "$tmp" sparse-checkout set -- packages/server/assets/skills/project &&
git -C "$tmp" checkout -q c7ee9e9dcc2d0922fddf60e53d3540119332e682 &&
mkdir -p .agents/skills &&
mkdir .agents/skills/open-knowledge &&
cp -R "$tmp"/packages/server/assets/skills/project/. .agents/skills/open-knowledge/ &&
rm -rf "$tmp"Or use the skills CLI from skills.sh. Installs the latest version, not the one we checked. The skills CLI reports installs to skills.sh unless you set DISABLE_TELEMETRY=1.
npx skills@1.7.4 add inkeep/open-knowledge --skill open-knowledgeWhat it can touch
From the files and frontmatter at commit c7ee9e9. This is how much a skill can do, not whether it is risky.
What it can touch: Shell, network or credentials
Runs shell commands
Its instructions or files give the agent commands to run on your computer.
Reaches the network
It sends or fetches data over the internet, for example with curl, an HTTP library or a package install.
Names web addresses
It mentions outside web addresses the agent may visit. We list them but don't follow them.
Pattern check
Pattern check: nothing flagged · commit c7ee9e9 · 27 Oct 2026
We checked every text file in this skill, at commit c7ee9e9 on 27 Oct 2026, against 45 published patterns such as download-and-run commands, hidden text and credential access. We don't run the skill, we don't read the web pages it points to, and we can't judge everything its instructions might lead an agent to do. In published tests, pattern checks like this one missed most malicious skills. Read the skill before you install it — especially anything it asks you to download or run.
How the check worksReport an incorrect finding
Outside links we did not follow
- https://github.com/inkeep/open-knowledge-skills
- https://openknowledge.ai/docs
- https://github.com/inkeep/open-knowledge
- https://URL
- https://openknowledge.ai/docs/get-started/quickstart
- https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f
Format check
Each agent reads SKILL.md a little differently. We check the file against each one's published rules; we don't run the skill in any agent.
Agent Skills specFails
The open format from agentskills.io, held to what the strictest agents enforce, so one folder loads everywhere.
- Error
The name "open-knowledge" doesn't match its folder "project". The spec requires them to match. N4
Fix: Set name: project, or rename the folder to open-knowledge.
- Note
There is no license field, so readers can't tell whether they may reuse the skill. O2
Fix: Add license: with an SPDX name such as MIT or Apache-2.0, or the name of a bundled licence file.
- Note
Reference files over 100 lines with no table of contents at the top: references/ingest-and-sources.md (244 lines) and references/onboard-existing-repo.md (320 lines). B5
Fix: Add a short list of the sections at the top of each.
- Error
Claude CodePasses
Claude Code reads its own extra fields, ignores unknown ones, and still loads a skill whose frontmatter is broken, without its fields.
- Note
The name "open-knowledge" doesn't match its folder "project". Claude Code shows the skill as /open-knowledge, and the folder name also invokes it. N4
Fix: Set name: project, or rename the folder to open-knowledge.
- Note
Reference files over 100 lines with no table of contents at the top: references/ingest-and-sources.md (244 lines) and references/onboard-existing-repo.md (320 lines). B5
Fix: Add a short list of the sections at the top of each.
- Note
Claude apps & API uploadFails
Uploading to claude.ai or the Claude API, or packaging with Anthropic's script, accepts only the six spec fields and stops on anything else.
- Error
The name "open-knowledge" doesn't match its folder "project". claude.ai refuses an upload whose folder name doesn't match the skill name. N4
Fix: Set name: project, or rename the folder to open-knowledge.
- Note
The description is 668 characters. The claude.ai Help Center says 200 at most, though Anthropic's API docs and validator allow 1,024. D4
Fix: If the claude.ai upload refuses it, trim the description to 200 characters.
- Note
Reference files over 100 lines with no table of contents at the top: references/ingest-and-sources.md (244 lines) and references/onboard-existing-repo.md (320 lines). B5
Fix: Add a short list of the sections at the top of each.
- Error
OpenAI (Codex & API)Passes with warnings
Codex finds SKILL.md by its exact name and needs a description; OpenAI's Skills API checks the frontmatter against the spec and caps uploads.
- Warning
The name "open-knowledge" doesn't match its folder "project". OpenAI's own upload example uses a differently named folder, but the spec it follows says they must match. N4
Fix: Set name: project, or rename the folder to open-knowledge.
- Warning
VS Code & CopilotPasses with warnings
VS Code reads skills one folder below .github/skills, .claude/skills or .agents/skills and falls back to the folder name when the name is missing or differs; GitHub's Copilot docs require the exact name SKILL.md.
- Warning
The name "open-knowledge" doesn't match its folder "project". VS Code uses the folder name, project, instead. N4
Fix: Set name: project, or rename the folder to open-knowledge.
- Warning
SKILL.md
We only show SKILL.md text here when its licence clearly allows it.
Read SKILL.md on GitHub (opens in a new tab)Files
17 files
More from inkeep/open-knowledge
codebase-wiki
inkeep/open-knowledge
How to work in a Codebase Wiki project (the `codebase-wiki` starter pack): an agent-authored, source-grounded wiki of the surrounding codebase. Read when the project has a `wiki/` knowledge base with `architecture/`, `modules/`, `flows/`, `concepts/`, and `guides/` sections plus `wiki/OVERVIEW.md`, or when asked to generate or refresh a wiki of this codebase. Carries the per-folder rules and freshness + log discipline, summarizes the audience/depth knobs and source-reference convention, and bundles the full generate/refresh procedure in `references/`. Complements the platform `open-knowledge` skill; does not replace it.
- Runs shell commands
- Names web addresses
Pattern check: Nothing flaggedGPL 3.0 · 4.7k repo stars · Updated 13 Oct 2026
consolidate-notes
inkeep/open-knowledge
Promote existing research into a stable-status canonical article under `articles/` in a Knowledge Base project (the `knowledge-base` starter pack). Read when a decision has actually been made and the team wants the source-of-truth written down, or when asked to consolidate, canonicalize, promote research, or supersede an older article. Carries the decision-confirmation gate, the `supersedes:` chain that keeps the evidence trail intact, and the canonical voice. Does not conduct new research — that is the sibling `research-with-sources` skill.
- Names web addresses
Pattern check: Nothing flaggedGPL 3.0 · 4.7k repo stars · Updated 13 Oct 2026
frame-a-proposal
inkeep/open-knowledge
Frame a new design proposal (RFC-shape) under proposals/ — problem before solution, named beneficiary and observable change, real alternatives, honest drawbacks, and a live open-questions backlog. Read when asked to frame a proposal, write an RFC, propose a design, pitch a change, draft a PRD-style design doc, or open a design proposal for review. Do NOT read to record a decision after it is accepted (use record-a-decision), to write an implementation spec (use write-a-spec), to write a postmortem (use write-a-postmortem), or to review or critique an existing design (use review-a-design).
- Names web addresses
Pattern check: Nothing flaggedGPL 3.0 · 4.7k repo stars · Updated 13 Oct 2026
knowledge-base
inkeep/open-knowledge
How to work in a Knowledge Base project (the `knowledge-base` starter pack). Read when the project has the three-layer source-grounded layout — `external-sources/` → `research/` → `articles/` — or when asked how this project is organized. Carries the layer model, per-folder rules, status flows, and log discipline so this guidance does NOT live inside template bodies or log.md. The three procedures live elsewhere: ingest in the platform `open-knowledge` skill, research and consolidate as their own sibling skills in this pack. Complements the platform `open-knowledge` skill; does not replace it.
- Names web addresses
Pattern check: Nothing flaggedGPL 3.0 · 4.7k repo stars · Updated 13 Oct 2026
note-taking
inkeep/open-knowledge
How to work in a Plain Notes project (the `plain-notes` starter pack): a flat notes/ folder plus a daily/ journal. The 'I just want to write' layout. Read when the project has these folders, OR when asked to jot a note, capture a quick thought, or write today's journal entry. Carries the linking habit and daily-entry behavior so templates and folder descriptions stay minimal. Complements the platform `open-knowledge` skill; does not replace it.
- Names web addresses
Pattern check: Nothing flaggedGPL 3.0 · 4.7k repo stars · Updated 13 Oct 2026
okf-knowledge-base
inkeep/open-knowledge
Open Knowledge Format (OKF) v0.2 guidance. Use when creating, reading, reviewing, or maintaining an OKF bundle; responding to OpenKnowledge `okf` plugin warnings; or choosing types, provenance, links, indexes, or logs.
- Names web addresses
Pattern check: Nothing flaggedGPL 3.0 · 4.7k repo stars · Updated 27 Aug 2026