notion-research-documentation — Claude Code skill: how to install
Searches your Notion workspace, pulls content from relevant pages, and writes structured research reports with citations.
npx skills add makenotion/claude-code-notion-plugin --skill notion-research-documentation -a claude-code
npx skills add makenotion/claude-code-notion-plugin --skill research-documentation -a claude-codeWhat notion-research-documentation does
The skill automates research workflows across a Notion workspace. The agent runs Notion:notion-search to locate matching documents and pulls full text with Notion:notion-fetch. Then it writes a documented summary via Notion:notion-create-pages.
Output formats include quick briefs and detailed reports. New content saves as a standalone page or directly inside a database using data_source_id. A parent document can be assigned with page_id. The workflow includes source citations linking back to original pages.
Execution requires appropriate Notion workspace permissions for every page in scope. If access rights are missing, searches fail to retrieve the necessary source text.
What it helps with
- locate relevant pages across a Notion workspace
- extract findings from multiple workspace notes
- compile structured research documents with source citations
- publish organized summaries directly into Notion databases
Example prompts for the agent
- Search Notion for technical architecture notes and write a summary report
- Review our onboarding pages in Notion and document key gaps
- Synthesize competitor notes from Notion and save a report under the strategy parent page
How to install notion-research-documentation
1Skills CLI (Vercel)
npx skills add makenotion/claude-code-notion-plugin --skill notion-research-documentation -a claude-codenpx skills add makenotion/claude-code-notion-plugin --skill research-documentation -a claude-code2Manually: put the files in place
~/.claude/skills/research-documentation/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/research-documentation/
1Skills CLI (Vercel)
npx skills add makenotion/claude-code-notion-plugin --skill research-documentation -a codex2Manually: put the files in place
.agents/skills/research-documentation/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add makenotion/claude-code-notion-plugin --skill research-documentation -a cursor2Manually: put the files in place
.cursor/skills/research-documentation/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install makenotion/claude-code-notion-plugin research-documentation2Manually: put the files in place
.github/skills/research-documentation/SKILL.md1Skills CLI (Vercel)
npx skills add makenotion/claude-code-notion-plugin --skill research-documentation -a gemini-cli2Platform CLI
gemini skills install https://github.com/makenotion/claude-code-notion-plugin --path skills/notion/research-documentationManually: put the files in place
.devin/skills/research-documentation/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add makenotion/claude-code-notion-plugin --skill research-documentation -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-research-documentation
How do you install notion-research-documentation in Claude Code?
Run npx skills add makenotion/claude-code-notion-plugin --skill notion-research-documentation -a claude-code.
What does notion-research-documentation do?
It queries Notion for relevant pages, gathers their text, resolves key findings across sources, and generates structured pages with backlinks to original materials.
Where does the skill save new research pages?
The skill defaults to standalone pages. You can also target a parent page using page_id or write into an existing database using data_source_id.
