# notion-research-documentation

Searches your Notion workspace, pulls content from relevant pages, and writes structured research reports with citations.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 355 installs · ★ 499
- Author: makenotion
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/makenotion/claude-code-notion-plugin/tree/HEAD/skills/notion/research-documentation/SKILL.md
- Updated: 2026-01-22
- HTML: https://affpapa.org/en/nevibecode/skills/notion-research-documentation-2

## What it 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.

## Requirements
- Works with: Notion

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add makenotion/claude-code-notion-plugin --skill notion-research-documentation -a claude-code
```
```bash
npx skills add makenotion/claude-code-notion-plugin --skill research-documentation -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/research-documentation/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/research-documentation/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add makenotion/claude-code-notion-plugin --skill research-documentation -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/research-documentation/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add makenotion/claude-code-notion-plugin --skill research-documentation -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/research-documentation/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install makenotion/claude-code-notion-plugin research-documentation
```

2. **Manually: put the files in place**
- File: `.github/skills/research-documentation/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add makenotion/claude-code-notion-plugin --skill research-documentation -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/makenotion/claude-code-notion-plugin --path skills/notion/research-documentation
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/research-documentation/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add makenotion/claude-code-notion-plugin --skill research-documentation -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/makenotion/claude-code-notion-plugin/tree/HEAD/skills/notion/research-documentation/SKILL.md

## When to use it
- 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
- 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

## Similar
- [deep-research](https://affpapa.org/en/nevibecode/skills/coreyhaines31-deep-research.md) — skill · 344 installs
- [notion-knowledge-capture](https://affpapa.org/en/nevibecode/skills/notion-knowledge-capture.md) — skill · 16 installs
- [notion-meeting-intelligence](https://affpapa.org/en/nevibecode/skills/notion-meeting-intelligence.md) — skill · 15 installs
- [notion-api](https://affpapa.org/en/nevibecode/skills/notion-api.md) — skill · 94900 installs
- [notion](https://affpapa.org/en/nevibecode/skills/notion.md) — skill · 5600 installs
- [notion-automation](https://affpapa.org/en/nevibecode/skills/notion-automation.md) — skill · 4800 installs

From the same set: [makenotion/claude-code-notion-plugin](https://affpapa.org/en/nevibecode/by/makenotion/claude-code-notion-plugin.md) — 5 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md