Official agent skill

Notion Research Documentation

by JetBrains in JetBrains/skills

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

OfficialMITAuto-check passedResearch & Science

Install Notion Research Documentation

skills CLI
$ npx skills add JetBrains/skills --skill notion-research-documentation -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install JetBrains/skills notion-research-documentation --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/JetBrains/skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/notion-research-documentation .claude/skills/notion-research-documentation && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
notion-research-documentation
GitHub stars
366
Used in
5 other repos
Token cost
~877 tokens
SKILL.md length
377 words
Files
23 (incl. assets)
Skills in repo
76
Repo updated
First seen
Licence
MIT

At a glance

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

  • Works in 6 steps: If any MCP call fails because Notion MCP… → Gather sources → Select the format → …
  • Gathering info from multiple Notion sources to produce briefs
  • SKILL.md covers Quick start, Workflow and References and examples
  • Calls codex; reaches mcp.notion.com

What it does

Notion Research Documentation is an agent skill from JetBrains/skills, published by the product's own GitHub organization. Research across Notion and synthesize into structured documentation; use when gathering info from multiple Notion sources to produce briefs, comparisons, or reports with citations.

Its SKILL.md is about 880 tokens, which your agent loads only when the skill is triggered. The skill folder holds 27 other files, including assets (for example `agents/openai.yaml`, `evaluations/README.md` and `evaluations/basic-research.json`).

It sits in Research & Science, covering Citation management. It works with Notion and Model Context Protocol. The repository describes itself as: Curated agent skills collection verified by JetBrains. The licence is MIT.

When your agent uses it

  • Gathering info from multiple Notion sources to produce briefs
  • Reports with citations

Example prompts

  • “/notion-research-documentation”

Workflow steps

6 steps, taken from the step headings in SKILL.md.

  1. If any MCP call fails because Notion MCP is not connected, pause and set it up
  2. Gather sources
  3. Select the format
  4. Synthesize
  5. Create the doc
  6. Finalize & handoff

What it can do on your machine

Read from SKILL.md and the folder at commit e0f258b. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • codex

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • mcp.notion.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Notion Research Documentation loads about 877 tokens when it runs. Until then it costs about 53 tokens; SKILL.md has 377 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~53
When it runs · the whole SKILL.md, loaded when a task matches
~877

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from JetBrains/skills at commit e0f258b, republished under its MIT licence (© JetBrains). 377 words, ~877 tokens.

Download SKILL.mdSave it as .claude/skills/notion-research-documentation/SKILL.md (or your agent's skills folder). This skill also uses 22 other files; get the full folder from GitHub.
name
notion-research-documentation
description
Research across Notion and synthesize into structured documentation; use when gathering info from multiple Notion sources to produce briefs, comparisons, or reports with citations.
metadata.short-description
Research Notion content and produce briefs/reports
metadata.author
OpenAI
metadata.source
https://github.com/openai/skills/tree/main/skills/.curated/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

  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.
Show full SKILL.md (138 more words)Show less
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).

© JetBrains, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 22 other files (assets) in notion-research-documentation of JetBrains/skills.

  • SKILL.md
  • LICENSE.txt
  • agents/openai.yaml
  • assets/notion-small.svg
  • assets/notion.png
  • evaluations/README.md
  • evaluations/basic-research.json
  • evaluations/research-to-database.json
  • examples/competitor-analysis.md
  • examples/market-research.md
  • examples/technical-investigation.md
  • examples/trip-planning.md
  • reference/advanced-search.md
  • reference/citations.md
  • reference/comparison-format.md
  • reference/comparison-template.md
  • … and 7 more

Open the folder on GitHubat commit e0f258b

Used in 5 other repositories

We found 5 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 5 other GitHub owners. This page covers the copy in JetBrains/skills, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Notion Research Documentation next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Notion Research Documentation compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Notion Research Documentation this skillJetBrains/skills3665 repos~877Automated safety check: PassMIT
Annotate Paper54yyyu/zotero-mcp5.3k—~1.5kAutomated safety check: PassMIT
NSFC Literature Review WriterHuiyuLi-2000/Chinese-Grant-Writer-Skills4391 repos~1.4kAutomated safety check: NotesMIT
Arxiv MCP Serverblazickjp/arxiv-mcp-server3.2k—~353Automated safety check: PassApache-2.0
Academic Search and Citation RouterYuan1z0825/nature-skills47k—~884Automated safety check: PassApache-2.0
Nature Academic Searchjing1312/nature-figure-skill171—~1.3kAutomated safety check: NotesMIT

Similar skills

  • Annotate Paper

    54yyyu/zotero-mcp

    Read the open paper and write study annotations into its PDF with zotero-cli - a context box on the title, a four-part summary on the abstract, role-coded abstract highlights, one box per figure…

    5.3k GitHub stars~1.5k tokensUpdated 2 days ago
    Research & ScienceAuto-check passed
  • NSFC Literature Review Writer

    HuiyuLi-2000/Chinese-Grant-Writer-Skills

    Writes the research-status literature review and critique section of an NSFC grant proposal, backed by a bundled multi-source literature search.

    439 GitHub starsUsed in 1 repo~1.4k tokens
    Research & ScienceAuto-check: notes
  • Arxiv MCP Server

    blazickjp/arxiv-mcp-server

    A skill your agent uses when finding, comparing, reading, or monitoring arXiv papers, including requests for abstracts, citation graphs, original LaTeX, section-level technical details, or…

    3.2k GitHub stars~353 tokensUpdated yesterday
    Research & ScienceAuto-check passed
  • Academic Search and Citation Router

    Yuan1z0825/nature-skills

    Finds papers across literature sources, verifies and converts citations, builds MeSH strategies and audits independent citations of a paper.

    47k GitHub stars~884 tokensUpdated today
    Research & ScienceAuto-check passed
  • Nature Academic Search

    jing1312/nature-figure-skill

    Multi-source literature search, citation verification, MeSH search strategy, citation file management (.nbib/.ris/.bib conversion), and reference management (BibTeX, related articles, ID conversion)…

    171 GitHub stars~1.3k tokensUpdated 1 mo ago
    Research & ScienceAuto-check: notes
  • CLI Anything Zotero

    PiaoyangGuohai1/cli-anything-zotero

    Full-featured CLI for Zotero reference management. An agent skill from PiaoyangGuohai1/cli-anything-zotero.

    138 GitHub stars~2.6k tokensUpdated 2 mo ago
    Research & ScienceAuto-check passed

More from JetBrains/skills

All 76 skills in this repo
  • Playwright

    JetBrains/skills

    Official

    A skill your agent uses when the task requires automating a real browser from the terminal (navigation, form filling, snapshots, screenshots, data extraction, UI-flow debugging) via playwright-cli…

    366 GitHub starsUsed in 11 repos~986 tokens
    Auto-check passed
  • Skill Creator

    JetBrains/skills

    Official

    Guide for creating effective skills. An agent skill from JetBrains/skills.

    366 GitHub starsUsed in 122 repos~4.7k tokens
    Auto-check passed
  • Transcribe

    JetBrains/skills

    Official

    Transcribe audio files to text with optional diarization and known-speaker hints.

    366 GitHub starsUsed in 4 repos~776 tokens
    Auto-check passed
  • Imagegen

    JetBrains/skills

    Official

    A skill your agent uses when the user asks to generate or edit images via the OpenAI Image API (for example: generate image, edit/inpaint/mask, background removal or replacement, transparent…

    366 GitHub starsUsed in 3 repos~2.5k tokens
    Auto-check passed
  • Speech

    JetBrains/skills

    Official

    A skill your agent uses when the user asks for text-to-speech narration or voiceover, accessibility reads, audio prompts, or batch speech generation via the OpenAI Audio API; run the bundled CLI…

    366 GitHub starsUsed in 3 repos~1.9k tokens
    Auto-check passed
  • Screenshot

    JetBrains/skills

    Official

    A skill your agent uses when the user explicitly asks for a desktop or system screenshot (full screen, specific app or window, or a pixel region), or when tool-specific capture capabilities are…

    366 GitHub starsUsed in 6 repos~2k tokens
    Auto-check passed

Questions about Notion Research Documentation

What does Notion Research Documentation do?

Research across Notion and synthesize into structured documentation; use when gathering info from multiple Notion sources to produce briefs, comparisons, or reports with citations. Notion Research Documentation is an agent skill from JetBrains/skills, published by the product's own GitHub organization. Research across Notion and synthesize into structured documentation; use when gathering info from multiple Notion sources to produce briefs, comparisons, or reports with citations.

When should I use Notion Research Documentation?

Notion Research Documentation fits situations like: gathering info from multiple Notion sources to produce briefs; reports with citations.

How do I install Notion Research Documentation in Claude Code?

Run `npx skills add JetBrains/skills --skill notion-research-documentation -a claude-code`. Or copy the skill folder (notion-research-documentation in JetBrains/skills) into .claude/skills/notion-research-documentation in your project. Claude Code loads it when a task matches its description.

How do I install Notion Research Documentation in Codex?

Run `npx skills add JetBrains/skills --skill notion-research-documentation -a codex`. Or copy the skill folder (notion-research-documentation in JetBrains/skills) into .agents/skills/notion-research-documentation in your project. Codex loads it when a task matches its description.

Can I use Notion Research Documentation in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add JetBrains/skills --skill notion-research-documentation -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/notion-research-documentation, .gemini/skills/notion-research-documentation, .github/skills/notion-research-documentation and .opencode/skills/notion-research-documentation in your project.

What does Notion Research Documentation need to run?

Going by SKILL.md and its folder, Notion Research Documentation needs the command-line tools its instructions call (codex).

Does Notion Research Documentation access the network?

SKILL.md names 1 domain. In commands or code: mcp.notion.com; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Notion Research Documentation safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Notion Research Documentation use?

Notion Research Documentation is published under the MIT licence (from the LICENSE file in the skill folder). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Notion Research Documentation use?

About 877 tokens (SKILL.md is roughly 3.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Notion Research Documentation?

Skills that share tags, products or a category with Notion Research Documentation: Annotate Paper (54yyyu/zotero-mcp, 5.3k stars), NSFC Literature Review Writer (HuiyuLi-2000/Chinese-Grant-Writer-Skills, 439 stars), Arxiv MCP Server (blazickjp/arxiv-mcp-server, 3.2k stars) and Academic Search and Citation Router (Yuan1z0825/nature-skills, 47k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Notion Research Documentation?

JetBrains (a GitHub organization, an official publisher) maintains it in JetBrains/skills, which has 366 GitHub stars. The repository holds 76 skills in this directory. The repository was last updated on June 29, 2026.

Source: JetBrains/skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.