---
id: sm-notion-research-documentation
name: "notion-research-documentation"
url: https://skills.yangsir.net/skill/sm-notion-research-documentation
author: openai
domain: writing
tags: ["notion", "research-management", "documentation", "knowledge-base", "collaboration-tools"]
install_count: 1400
rating: 4.30 (49 reviews)
github: https://github.com/openai/skills
---

# notion-research-documentation

> 从 Notion 提取相关页面，综合研究发现，并发布带有引用和来源链接的清晰简报或报告。

**Stats**: 1,400 installs · 4.3/5 (49 reviews)

## Before / After 对比

### 整合Notion研究并生成报告

## Readme

# notion-research-documentation

# Research & Documentation

Pull relevant Notion pages, synthesize findings, and publish clear briefs or reports (with citations and links to sources).

## Quick start

- Find sources with `Notion:notion-search` using targeted queries; confirm scope with the user.

- Fetch pages via `Notion:notion-fetch`; note key sections and capture citations (`reference/citations.md`).

- Choose output format (brief, summary, comparison, comprehensive report) using `reference/format-selection-guide.md`.

- Draft in Notion with `Notion:notion-create-pages` using the matching template (quick, summary, comparison, comprehensive).

- Link sources and add a references/citations section; update as new info arrives with `Notion:notion-update-page`.

## Workflow

### 0) If any MCP call fails because Notion MCP is not connected, pause and set it up:

- Add the Notion MCP:

`codex mcp add notion --url https://mcp.notion.com/mcp`

- Enable remote MCP client:

Set `[features].rmcp_client = true` in `config.toml` **or** run `codex --enable rmcp_client`

- Log in with OAuth:

`codex mcp login notion`

After successful login, the user will have to restart codex. You should finish your answer and tell them so when they try again they can continue with Step 1.

### 1) Gather sources

- Search first (`Notion:notion-search`); refine queries, and ask the user to confirm if multiple results appear.

- Fetch relevant pages (`Notion:notion-fetch`), skim for facts, metrics, claims, constraints, and dates.

- Track each source URL/ID for later citation; prefer direct quotes for critical facts.

### 2) Select the format

- Quick readout → quick brief.

- Single-topic dive → research summary.

- Option tradeoffs → comparison.

- Deep dive / exec-ready → comprehensive report.

- See `reference/format-selection-guide.md` for when to pick each.

### 3) Synthesize

- Outline before writing; group findings by themes/questions.

- Note evidence with source IDs; flag gaps or contradictions.

- Keep user goal in view (decision, summary, plan, recommendation).

### 4) Create the doc

- Pick the matching template in `reference/` (brief, summary, comparison, comprehensive) and adapt it.

- Create the page with `Notion:notion-create-pages`; include title, summary, key findings, supporting evidence, and recommendations/next steps when relevant.

- Add citations inline and a references section; link back to source pages.

### 5) Finalize & handoff

- Add highlights, risks, and open questions.

- If the user needs follow-ups, create tasks or a checklist in the page; link any task database entries if applicable.

- Share a short changelog or status using `Notion:notion-update-page` when updating.

## References and examples

- `reference/` — search tactics, format selection, templates, and citation rules (e.g., `advanced-search.md`, `format-selection-guide.md`, `research-summary-template.md`, `comparison-template.md`, `citations.md`).

- `examples/` — end-to-end walkthroughs (e.g., `competitor-analysis.md`, `technical-investigation.md`, `market-research.md`, `trip-planning.md`).

Weekly Installs404Repository[openai/skills](https://github.com/openai/skills)GitHub Stars14.5KFirst SeenJan 20, 2026Security Audits[Gen Agent Trust HubPass](/openai/skills/notion-research-documentation/security/agent-trust-hub)[SocketPass](/openai/skills/notion-research-documentation/security/socket)[SnykPass](/openai/skills/notion-research-documentation/security/snyk)Installed oncodex355opencode342gemini-cli328cursor311github-copilot307amp284

---
*Source: https://skills.yangsir.net/skill/sm-notion-research-documentation*
*Markdown mirror: https://skills.yangsir.net/api/skill/sm-notion-research-documentation/markdown*