skilld
All skills
openai avatar

/notion-research-documentation

@136d58a official
by openaiopenai/skills28k stars
1,891

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

Ask your Agent

Use this Skill: https://skilld.dev/gh/openai/skills/notion-research-documentation

This session only. Nothing lands on disk.

SKILL.md

≈53 tokens always: the name and description. ≈771 when used: this file. ≈12k more on demand in 19 files.

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).

Source: SKILL.md on GitHub

Third-party checks

2 warnings16d5 checks · Risk SAFE
  • Gen Agent Trust Hub16d

    This skill facilitates research and synthesis of Notion workspace content into structured documentation. It includes a security consideration regarding potential indirect prompt injection from untrusted Notion pages, but overall operates within its intended functionality for source attribution and report generation.

  • Socket16d

    No alerts

  • Snyk16d

    Risk: MEDIUM · 1 issue

  • Runlayer7mo

    21/21 files flagged

  • ZeroLeaks5mo

    Score: 93/100 · 2 sections analyzed

Provenance

Signed by skilld at 136d58a. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 2 months ago.

Activeupdated 10 months ago

Capability

metadata
{
  "short-description": "Research Notion content and produce briefs/reports"
}

Topics

README badge

README badge for openai/skills/notion-research-documentation

What it does

Searches Notion pages, synthesizes findings into structured briefs or reports, and maintains citations and source links. Use this to gather information across multiple Notion sources and produce comparisons, research summaries, or executive briefs with inline references.

Generated from the current SKILL.md.

Frequently asked

Does this skill work with Claude or only specific AI agents?
The skill is designed for Claude and other AI coding agents. It requires the Notion MCP (Model Context Protocol) to be installed and connected via OAuth.
What Notion operations does this skill support?
The skill supports searching Notion pages, fetching page content, creating new pages from templates, and updating existing pages with citations and references.
Can I use this skill without setting up the Notion MCP first?
No. If the Notion MCP is not connected, you must add it, enable the remote MCP client in your config, and log in with OAuth before the skill can function.
What output formats does this skill support?
The skill supports quick briefs, research summaries, comparisons, and comprehensive reports. A format-selection guide is included to help choose the right template for your goal.
Does this skill handle citations and source tracking?
Yes. The skill requires tracking source URLs and IDs, supports inline citations, and creates a references section in the output document.

Generated from the current SKILL.md. These answers refresh after source changes.