notion-knowledge-capture · makenotion — Claude Code skill: chat notes into Notion
Turns a chat discussion into a structured Notion page: pulls out decisions, insights and how-tos, formats them and files them where they belong.
npx skills add makenotion/claude-code-notion-plugin --skill notion-knowledge-capture -a claude-code
npx skills add makenotion/claude-code-notion-plugin --skill knowledge-capture -a claude-codeWhat notion-knowledge-capture does
The skill reads the conversation and picks out what is worth keeping: definitions, decisions with their rationale, step-by-step procedures, question-and-answer pairs, examples. It then classifies the material — concept, how-to, decision record, FAQ, meeting summary — and lays it out in the structure that fits that type.
It runs on the Notion MCP server. First it looks for a suitable wiki page or database with Notion:notion-search, then writes the page with Notion:notion-create-pages. There is a separate step for making the result findable: add a link to the wiki index, set tags and status in the database, attach the page to its parent. Skip that step and the document sits orphaned in the workspace where nobody will run into it.
A connected Notion MCP server with access to your workspace is the prerequisite — without it the notion-search and notion-create-pages calls have nowhere to go. For databases with properties the skill leans on the schemas described in reference/database-best-practices.md, so it pays to have the database structure in place beforehand.
What it helps with
- save a decision from a thread as its own page with rationale
- build an FAQ out of questions asked in chat
- write up a how-to from steps worked out in conversation
- log meeting outcomes into a decision database
- link a new page into the wiki index so people find it
Example prompts for the agent
- save this discussion to Notion as a decision record
- turn our conversation into a how-to and drop it in the docs database
- format this as an FAQ page and link it from the wiki index
How to install notion-knowledge-capture
1Skills CLI (Vercel)
npx skills add makenotion/claude-code-notion-plugin --skill notion-knowledge-capture -a claude-codenpx skills add makenotion/claude-code-notion-plugin --skill knowledge-capture -a claude-code2Manually: put the files in place
~/.claude/skills/knowledge-capture/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/knowledge-capture/
1Skills CLI (Vercel)
npx skills add makenotion/claude-code-notion-plugin --skill knowledge-capture -a codex2Manually: put the files in place
.agents/skills/knowledge-capture/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add makenotion/claude-code-notion-plugin --skill knowledge-capture -a cursor2Manually: put the files in place
.cursor/skills/knowledge-capture/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install makenotion/claude-code-notion-plugin knowledge-capture2Manually: put the files in place
.github/skills/knowledge-capture/SKILL.md1Skills CLI (Vercel)
npx skills add makenotion/claude-code-notion-plugin --skill knowledge-capture -a gemini-cli2Platform CLI
gemini skills install https://github.com/makenotion/claude-code-notion-plugin --path skills/notion/knowledge-captureManually: put the files in place
.devin/skills/knowledge-capture/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add makenotion/claude-code-notion-plugin --skill knowledge-capture -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about notion-knowledge-capture
How do I install notion-knowledge-capture in Claude?
Run npx skills add makenotion/claude-code-notion-plugin --skill notion-knowledge-capture -a claude-code. The skill lands in ~/.claude/skills/knowledge-capture/SKILL.md.
What does notion-knowledge-capture do?
It reads the chat context, extracts decisions, procedures and insights, fits them to the matching template and creates a Notion page through the MCP server.
What does the skill need to work?
A connected Notion MCP server with access to your workspace, since the skill calls Notion:notion-search and Notion:notion-create-pages.
Similar skills
All skills for Notes, tasks and projects →notion-knowledge-capture by other authors comes first.
