# Notion Research Documentation

> Research across Notion and synthesize into structured documentation; use when gathering info from multiple Notion sources to produce briefs, comparisons, or reports with citations.

- Skill: `lidge-jun/notion-research-documentation` (Agent Skill)
- Install (CLI): `npx skillmds@latest add lidge-jun/notion-research-documentation`
- Raw SKILL.md: https://api.skillmd.com/api/skills/lidge-jun/notion-research-documentation/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: lidge-jun (https://skillmd.com/u/lidge-jun)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/lidge-jun/notion-research-documentation

---


# Research & Documentation

Pull Notion pages, synthesize findings, and publish cited briefs or reports.

Why this skill? Notion knowledge is scattered across pages. Without systematic search + citation, research outputs miss context or make unsourced claims.

## Notion MCP setup (only if MCP calls fail)
1. `codex mcp add notion --url https://mcp.notion.com/mcp`
2. Set `[features].rmcp_client = true` in `config.toml`
3. `codex mcp login notion` — then restart Codex.

## Rules

1. **Search broadly, then narrow**: use `Notion:notion-search` with multiple query variations. Ask the user to confirm scope when results are ambiguous.
2. **Track every source**: record each fetched page's URL/ID. Use direct quotes for critical facts. Why: unsourced claims in research docs erode trust.
3. **Choose format by purpose**:
   - Quick readout → brief (1 page, key points only)
   - Single-topic dive → summary (findings + evidence)
   - Option tradeoffs → comparison (structured pros/cons/criteria table)
   - Deep dive / exec-ready → comprehensive report (full sections + recommendations)
4. **Outline before writing**: group findings by themes or questions. Flag gaps and contradictions explicitly.
5. **Create in Notion** via `Notion:notion-create-pages`. Every doc must include: title, summary, key findings, supporting evidence, inline citations, and a references section linking source pages.
6. **Finalize**: add highlights, risks, open questions. Create follow-up tasks if needed. Use `Notion:notion-update-page` for updates.