Notion Research Synthesizer
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.
--- 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 --- # 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`.
Overview
Pull relevant Notion pages, synthesize findings, and publish clear briefs or reports (with citations and links to sources).
Manual install (npx, ZIP)
Claude Code
npx skills add davila7/claude-code-templates --skill notion-research-documentation -g -a claude-codeClaude Code (degit)
npx degit davila7/claude-code-templates/cli-tool/components/skills/productivity/notion-research-documentation#main ~/.claude/skills/notion-research-documentationClaude.ai / desktop
Codex, Cursor, other agents
Connects with Agent Alley MCP · agentalley.io/mcp
Files included
SKILL.md3.3 KB
Read SKILL.md here
SKILL.md
Show the full text60 lines
Research & Documentation
Pull relevant Notion pages, synthesize findings, and publish clear briefs or reports (with citations and links to sources).
Quick start
- Find sources with
Notion:notion-searchusing targeted queries; confirm scope with the user. - Fetch pages via
Notion:notion-fetch; note key sections and capture citations (reference/citations.md). - Choose output format (brief, summary, comparison, comprehensive report) using
reference/format-selection-guide.md. - Draft in Notion with
Notion:notion-create-pagesusing the matching template (quick, summary, comparison, comprehensive). - 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:
- Add the Notion MCP:
codex mcp add notion --url https://mcp.notion.com/mcp
- Enable remote MCP client:
- Set
[features].rmcp_client = trueinconfig.tomlor runcodex --enable rmcp_client
- Set
- 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.mdfor 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-pagewhen 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).
| 1 | |
| 2 | name notion-research-documentation |
| 3 | 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. |
| 4 | metadata |
| 5 | short-description Research Notion content and produce briefs/reports |
| 6 | |
| 7 | |
| 8 | # Research & Documentation |
| 9 | |
| 10 | Pull relevant Notion pages, synthesize findings, and publish clear briefs or reports (with citations and links to sources). |
| 11 | |
| 12 | ## Quick start |
| 13 | 1) Find sources with `Notion:notion-search` using targeted queries; confirm scope with the user. |
| 14 | 2) Fetch pages via `Notion:notion-fetch`; note key sections and capture citations (`reference/citations.md`). |
| 15 | 3) Choose output format (brief, summary, comparison, comprehensive report) using `reference/format-selection-guide.md`. |
| 16 | 4) Draft in Notion with `Notion:notion-create-pages` using the matching template (quick, summary, comparison, comprehensive). |
| 17 | 5) Link sources and add a references/citations section; update as new info arrives with `Notion:notion-update-page`. |
| 18 | |
| 19 | ## Workflow |
| 20 | ### 0) If any MCP call fails because Notion MCP is not connected, pause and set it up: |
| 21 | Add the Notion MCP: |
| 22 | `codex mcp add notion --url https://mcp.notion.com/mcp` |
| 23 | Enable remote MCP client: |
| 24 | Set `[features].rmcp_client = true` in `config.toml` **or** run `codex --enable rmcp_client` |
| 25 | Log in with OAuth: |
| 26 | `codex mcp login notion` |
| 27 | |
| 28 | 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. |
| 29 | |
| 30 | ### 1) Gather sources |
| 31 | Search first (`Notion:notion-search`); refine queries, and ask the user to confirm if multiple results appear. |
| 32 | Fetch relevant pages (`Notion:notion-fetch`), skim for facts, metrics, claims, constraints, and dates. |
| 33 | Track each source URL/ID for later citation; prefer direct quotes for critical facts. |
| 34 | |
| 35 | ### 2) Select the format |
| 36 | Quick readout → quick brief. |
| 37 | Single-topic dive → research summary. |
| 38 | Option tradeoffs → comparison. |
| 39 | Deep dive / exec-ready → comprehensive report. |
| 40 | See `reference/format-selection-guide.md` for when to pick each. |
| 41 | |
| 42 | ### 3) Synthesize |
| 43 | Outline before writing; group findings by themes/questions. |
| 44 | Note evidence with source IDs; flag gaps or contradictions. |
| 45 | Keep user goal in view (decision, summary, plan, recommendation). |
| 46 | |
| 47 | ### 4) Create the doc |
| 48 | Pick the matching template in `reference/` (brief, summary, comparison, comprehensive) and adapt it. |
| 49 | Create the page with `Notion:notion-create-pages`; include title, summary, key findings, supporting evidence, and recommendations/next steps when relevant. |
| 50 | Add citations inline and a references section; link back to source pages. |
| 51 | |
| 52 | ### 5) Finalize & handoff |
| 53 | Add highlights, risks, and open questions. |
| 54 | If the user needs follow-ups, create tasks or a checklist in the page; link any task database entries if applicable. |
| 55 | Share a short changelog or status using `Notion:notion-update-page` when updating. |
| 56 | |
| 57 | ## References and examples |
| 58 | `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`). |
| 59 | `examples/` — end-to-end walkthroughs (e.g., `competitor-analysis.md`, `technical-investigation.md`, `market-research.md`, `trip-planning.md`). |
| 60 |
Details
- License
- MIT
- Stars on the repo
- ★ 32,299
- Checked
- Source
- davila7/claude-code-templates ↗
- Creator
- davila7 · 212 listings
Similar skills
See all →
SkillChangelog Generator
runkids/skillshare · by runkidsGenerate CHANGELOG.md entry from recent commits in conventional format. Also syncs the website changelog page. Use this skill whenever the user asks to: generate a changelog, document what changed between tags, or create a new CHANGELOG entry. If you see requests like "write the changelog for v0.17", what changed since last release", this is the skill to use. Do NOT manually edit CHANGELOG.md without this skill — it ensures proper formatting, user-perspective writing, and website changelog sync. For full release workflows (Release PR review, tests, draft assets, publication, announcements), use /release instead.★ 2.7k GitHub stars
SkillDocumentation Updaterrunkids/skillshare · by runkidsUpdate website docs to match recent code changes, cross-validating every flag against source. Use this skill whenever the user asks to: update documentation, sync docs with code, document a new flag or command, fix stale docs, or update the README. This skill covers all website/docs/ categories (commands, reference, understand, how-to, troubleshooting, getting-started) plus the built-in skill description and README. If you just implemented a feature and need to update docs, this is the skill to use. Never manually edit website docs without cross-validating flags against Go source first.★ 2.7k GitHub stars
SkillArchitecture Decision Recorder
levnikolaevich/claude-code-skills · by levnikolaevichRecords one architecture decision with alternatives, consequences and status; does not design the whole system.★ 568 GitHub stars
SkillArchitecture Decision Records
addyosmani/agent-skills · by addyosmaniRecords decisions and documentation. Use when you need to document an architecture decision (ADR) or the reasoning behind a design choice, when changing public APIs, shipping features, or when you need to record context that future engineers and agents will need to understand the codebase.★ 98.7k GitHub stars
SkillTreatment Plan Validator
K-Dense-AI/scientific-agent-skills · by K-Dense-AIFormat and structurally validate local treatment-plan documentation after clinical decisions have already been supplied and verified by authorized licensed professionals. Use for source traceability, clinician-authored intervention records, goals and checkpoints, shared-decision records, reconciliation handoffs, and release gates—not for clinical decision-making.★ 46k GitHub stars
SkillCodebase Scanner
wshobson/agents · by wshobsonScans the codebase to generate project-doc.md and AGENTS.md. Use when bootstrapping a new agent-driven repo, refreshing project documentation after architectural changes, or running a delta scan to detect drift. Runs a full scan on first use and a smart delta scan on subsequent runs. Uses understand-anything + context-mode when available, falls back to native tools otherwise. Only updates AGENTS.md on detected architectural changes with human confirmation.★ 39.9k GitHub starsMore from davila7
Skill2D Game Development
davila7/claude-code-templates · by davila72D game development principles. Sprites, tilemaps, physics, camera.★ 32.3k GitHub stars
Skill3D Game Development Principlesdavila7/claude-code-templates · by davila73D game development principles. Rendering, shaders, physics, cameras.★ 32.3k GitHub stars
Skill3D Web Experience Builderdavila7/claude-code-templates · by davila7Expert in building 3D experiences for the web - Three.js, React Three Fiber, Spline, WebGL, and interactive 3D scenes. Covers product configurators, 3D portfolios, immersive websites, and bringing depth to web experiences. Use when: 3D website, three.js, WebGL, react three fiber, 3D experience.★ 32.3k GitHub stars
SkillSplit Test Setupdavila7/claude-code-templates · by davila7When the user wants to plan, design, or implement an A/B test or experiment. Also use when the user mentions "A/B test," "split test," "experiment," "test this change," "variant copy," "multivariate test," or "hypothesis." For tracking implementation, see analytics-tracking.★ 32.3k GitHub stars
AgentResearch Literature Synthesizerdavila7/claude-code-templates · by davila7Academic research synthesis specialist. Use PROACTIVELY for comprehensive research on academic topics, literature reviews, technical investigations, and well-cited analysis combining multiple sources. <example>Context: A podcast episode needs a segment grounded in peer-reviewed evidence with formal citations. user: "Research the current state of transformer efficiency techniques for the episode, with proper academic citations." assistant: "I'll use the academic-research-synthesizer agent to search arXiv and Semantic Scholar, extract full-text findings via WebFetch, and produce a cited literature synthesis with confidence levels." <commentary>Use academic-research-synthesizer (not comprehensive-researcher) when the episode segment needs peer-reviewed sourcing, formal citation format, and explicit confidence tagging rather than general-purpose multi-source coverage.</commentary></example> <example>Context: The episode-orchestrator has routed a "literature review" request for a technical deep-dive segment. user: "Summarize the research landscape on federated learning privacy guarantees." assistant: "I'll invoke academic-research-synthesizer to systematically search academic sources, note peer-review status per source, and synthesize consensus vs. open debates."</example>★ 32.3k GitHub stars
AgentAcademic Research Specialistdavila7/claude-code-templates · by davila7Academic research specialist for scholarly sources, peer-reviewed papers, and academic literature. Use PROACTIVELY for research paper analysis, literature reviews, citation tracking, and academic methodology evaluation. <example>Context: The research-orchestrator has kicked off Phase 4 parallel research on 'efficacy of intermittent fasting' and needs peer-reviewed evidence. user: "Find the academic evidence on intermittent fasting outcomes." assistant: "I'll use the academic-researcher agent to search Semantic Scholar, PubMed, and OpenAlex for peer-reviewed studies and write structured findings to academic-research.md." <commentary>The request is specifically for scholarly/peer-reviewed evidence rather than general web coverage or code, so academic-researcher (not web-researcher or technical-researcher) is the right specialist.</commentary></example> <example>Context: The user wants a literature review comparing methodologies across studies on a topic. user: "Can you review the literature on transformer model interpretability and identify research gaps?" assistant: "Let me invoke the academic-researcher agent to pull foundational and recent papers, extract methodologies, and surface open research gaps." <commentary>Literature review, methodology extraction, and research-gap identification are core academic-researcher capabilities, distinct from technical-researcher's focus on code repositories and implementations.</commentary></example>★ 32.3k GitHub stars