SkillContent

Notion Research Documentation

OpenAI1.8k

Research across Notion and synthesize into structured briefs, comparisons, or reports with citations. Perfect for UX researchers gathering info from multiple sources.

How to install

npx skills add github.com/openai/skills/tree/main/skills/.curated/notion-research-documentation --skill notion-research-documentation

Installs to .cursor/skills/

Manual install
  1. Copy SKILL.md below
  2. .cursor/skills/notion-research-documentation/SKILL.md
Cursor docs

SKILL.md

---
name: notion-research-documentation
description: Research across Notion and synthesize into structured documentation with citations.
---

# 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 targeted search queries; confirm scope with user
2. Fetch pages; note key sections and capture citations
3. Choose output format (brief, summary, comparison, comprehensive report)
4. Draft in Notion using the matching template
5. Link sources and add references section; update as new info arrives

## Workflow

### 1) Gather Sources
- Search first; refine queries if multiple results appear
- Fetch relevant pages, skim for facts, metrics, claims, constraints, 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

### 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 Document
- Pick the matching template and adapt it
- Include: title, summary, key findings, supporting evidence, recommendations
- Add citations inline and a references section
- Link back to source pages

### 5) Finalize & Handoff
- Add highlights, risks, and open questions
- If user needs follow-ups, create tasks or checklist
- Share changelog or status when updating

## Output Formats

### Quick Brief
- 1-2 page summary
- Key takeaways upfront
- Bullet points for speed

### Research Summary
- 3-5 pages
- Background context
- Detailed findings
- Methodology notes

### Comparison
- Side-by-side analysis
- Pros/cons for each option
- Recommendation with rationale

### Comprehensive Report
- Executive summary
- Full analysis
- Supporting data
- Appendices

Skills, agents & workflow notes

Weekly SKILL.md-style workflows, Cursor and Claude Code tips, and AI interface craft on Substack - no spam, unsubscribe anytime.

Subscribe on Substack