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.

examplesmarket-research.md

≈475 tokens on demand. Your agent reads this file only when SKILL.md points to it.

Example: Market Research

User Request: "Research the current state of AI coding assistants market and create a summary document in Notion"

Workflow

1. Search

Notion:notion-search
query: "AI coding assistants market"

Found 3 relevant pages across Engineering, Strategy, and Product teamspaces.

2. Fetch & Analyze

Notion:notion-fetch (3x)

Extracted market size, competitive landscape, technology trends from source pages.

3. Create Documentation

Notion:notion-create-pages

Output (Condensed)

# AI Coding Assistants Market Research - Oct 2025

## Executive Summary
The AI coding assistant market is experiencing 150%+ YoY growth. GitHub Copilot dominates with 60% share, but specialized tools are gaining traction in specific niches.

## Key Findings

### Market Size and Growth
$800M in 2024 → $2.5B projected by 2026. Developer adoption: 23% (2023) → 47% (2024).
Source: <mention-page url="...">Market Trends Q3 2025</mention-page>

### Competitive Landscape
- GitHub Copilot: 60% (strong IDE integration)
- Cursor: 15% (rapid growth, full IDE)
- Tabnine: 10% (enterprise, on-premise)
- Cody: 5% (codebase-aware)
- CodeWhisperer: 8% (AWS integration)
Source: <mention-page url="...">AI Tools Competitive Analysis</mention-page>

### Technology Trends
Key differentiators: context awareness, customization, multi-modal interfaces, code verification.
Source: <mention-page url="...">Developer Tools Landscape</mention-page>

## Next Steps
1. Monitor Cursor growth and feature releases
2. Evaluate Cody's codebase-aware capabilities
3. Document enterprise security/compliance requirements
4. Track pricing trends

Key Takeaways

  • Found relevant pages across multiple teamspaces
  • Synthesized competitive, market, and technical perspectives
  • Used proper citations linking to source pages
  • Created actionable recommendations

Source: SKILL.md on GitHub

Third-party checks

2 warnings17d5 checks · Risk SAFE
  • Gen Agent Trust Hub17d

    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.

  • Socket17d

    No alerts

  • Snyk17d

    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.