Let AI save and find your Markdown

Keep turns links, videos, PDFs, audio, images, and thoughts into Markdown. The Keep skill teaches compatible AI tools how to save, search, read, and update that Markdown.

Install

If you use the Keep CLI:

keep skill install

Or install directly from Keep:

npx skills add https://keep.md --skill keep

yarn dlx skills add https://keep.md --skill keep

pnpm dlx skills add https://keep.md --skill keep

bunx skills add https://keep.md --skill keep

For non-interactive installs (CI or automation):

npx skills add https://keep.md --skill keep --all

yarn dlx skills add https://keep.md --skill keep --all

pnpm dlx skills add https://keep.md --skill keep --all

bunx skills add https://keep.md --skill keep --all

The install includes the skill instructions and its OpenAI interface metadata.

Check for updates at any time:

keep skill status
keep skill update

What AI can do

With the skill installed, compatible AI tools can:

• recognise recall cues such as “I saved a site a few months ago” and search without needing an exact title or URL
• search notes and saved items together with semantic and keyword matching
• read attached sources, highlights, summaries, and bounded full content
• create or update notes for thoughts, ideas, decisions, preferences, and learning
• capture a promising idea, such as a future blog post, without copying the whole conversation
• attach saved items as evidence instead of copying whole articles into notes
• process inbox items and work with automated sources and sync workflows

The skill does not search on every ordinary request or save every session. It saves useful durable context, not full chat transcripts, secrets, temporary logs, generic facts, or unsupported guesses.

The Keep loop

The skill gives each compatible AI client the same small workflow:

1. Search when you refer to something saved, read, watched, or discussed before.
2. Open only the Notes or saved Items that matter.
3. Search again before saving, then improve an existing Note or create one.
4. Before finishing substantial work, consider zero to three durable outcomes worth carrying forward.

Zero saved outcomes is normal. Keep prefers one living Note per topic over a new Note after every conversation.

Notes are editable knowledge. Saved Items are captured source material. Adding commentary to an Item creates or updates a Note and links the Item as evidence rather than changing the captured content.

The skill uses keep search for Notes and Items together. It uses keep notes search or keep items search when it needs one resource type. keep context remains available for advanced Git Project workflows.

Search returns a small map, not whole documents. When a Note result includes a useful line range, the AI can fetch that revision-pinned slice directly. For a broader match, it opens the overview, searches within that revision, then fetches an exact slice. The complete body is the last resort.

Each connected agent uses the same library. A named credential records which client changed a Note. Revision checks stop a stale client from silently overwriting a newer change. See Connected agents.

Requirements

Use the authenticated Keep CLI where a terminal is available, or connect the Keep MCP server to a compatible AI client. Both provide access to the same Keep library.

Advanced Project metadata and session hooks remain available for existing coding workflows. They are optional and are not part of normal setup.