SkillRepo
Sign InSign Up
Catalog
openai/notion-research-documentation

openai

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.

global
short-description:Research Notion content and produce briefs/reports
0installs0uses—~813
v1.0Saved Apr 5, 2026

Research & Documentation

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

Quick start

  1. Find sources with Notion:notion-search using targeted queries; confirm scope with the user.
  2. Fetch pages via Notion:notion-fetch; note key sections and capture citations (reference/citations.md).
  3. Choose output format (brief, summary, comparison, comprehensive report) using reference/format-selection-guide.md.
  4. Draft in Notion with Notion:notion-create-pages using the matching template (quick, summary, comparison, comprehensive).
  5. 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:

  1. Add the Notion MCP:
    • codex mcp add notion --url https://mcp.notion.com/mcp
  2. Enable remote MCP client:
    • Set [features].rmcp_client = true in config.toml or run codex --enable rmcp_client
  3. 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).
Files22
22 files · 72.1 KB

Select a file to preview

Overall Score

86/100

Grade

A

Excellent

Safety

88

Quality

88

Clarity

87

Completeness

82

Summary

This skill enables AI agents to research content across Notion workspaces and synthesize findings into structured documentation (briefs, reports, comparisons). It provides step-by-step workflows for searching Notion pages, selecting appropriate output formats, and creating well-cited documents with clear recommendations.

Detected Capabilities

Notion workspace search with filtering (date range, creator, teamspace)Multi-page content fetching and synthesisFormat selection (quick brief, research summary, comparison, comprehensive report)Document creation in Notion with proper markdown and citationsPage-to-page linking and reference managementCitation formatting with mention-page tagsMCP client setup and OAuth integration guidance

Trigger Keywords

Phrases that MCP clients use to match this skill to user intent.

research notion pagessynthesize documentationcreate comparison analysiscompetitive intelligencemarket research summarytechnical investigation reportgather sources citationscreate brief from research

Risk Signals

INFO

MCP client setup requires enabling remote MCP and OAuth login

SKILL.md section 0, step 2-3
INFO

Agents must authenticate with Notion via OAuth before research can proceed

SKILL.md workflow section 0, step 3
INFO

Skill creates and modifies pages in Notion workspace using Notion:notion-create-pages and Notion:notion-update-page

SKILL.md quick start and workflow sections
INFO

Search scope can be restricted to specific teamspaces, pages, or databases

reference/advanced-search.md scoping sections

Referenced Domains

External domains referenced in skill content, detected by static analysis.

mcp.notion.comnotion.so

Use Cases

  • Research competitor pricing strategies and create comparison documents
  • Gather technical architecture information and produce implementation summaries
  • Synthesize market research across multiple Notion sources for executive briefings
  • Compile team feedback and decisions into consolidated reports with citations
  • Investigate product roadmap details and create strategic planning documents

Quality Notes

  • Excellent documentation structure with clear decision trees and workflow steps
  • Comprehensive reference materials including advanced search techniques, citation rules, and format selection guides
  • Practical examples demonstrate full workflows with realistic outputs (competitor analysis, technical investigation, trip planning)
  • Well-defined format templates with clear use cases for each (quick brief, research summary, comparison, comprehensive report)
  • Evaluation scenarios (evaluations/ directory) provide testable success criteria for different research types
  • Strong guidance on citation practices with specific mention-page tag syntax
  • Clear error handling documented: step 0 addresses MCP connection failures with setup instructions
  • Good edge case coverage: handling too many search results, too few results, broad-to-narrow search strategy
  • Limitations section in quick-brief-format.md and others helps users understand scope of each format
  • Agent configuration (agents/openai.yaml) properly declares Notion MCP dependency with streamable_http transport
  • Multiple examples show workflow patterns: date filtering, multi-source synthesis, format selection, proper placement
Model: claude-haiku-4-5-20251001Analyzed: Apr 5, 2026

Reviews

Add this skill to your library to leave a review.

No reviews yet

Be the first to share your experience.

Add openai/notion-research-documentation to your library

Get Started Free

Command Palette

Search for a command to run...