notion-research-documentation
Verifiedby davila7 · Updated Apr 16, 2026
Research across Notion and synthesize into structured documentation; use when gathering info from multiple Notion sources to produce briefs, comparisons, or reports with citations.
See It In Action
I'll help you create an exec-ready brief on onboarding tests and retros for your growth review. Let me first explore the codebase to find the relevant test results and retrospective data.
I can see this is a temporary directory with template/example files, but I don't see any actual onboarding test results or retrospective data from your project.
To create the exec-ready brief you need for today's growth review, I'll need access to:
- Your actual onboarding test results (A/B tests, experiments, user testing)
- Retrospective documents or notes
- Any signup conversion data or analysis
- User research or interview notes
Could you either:
- Navigate to your actual project directory where this data lives, or
- Point me to the specific Notion workspace/files you want me to analyze, or
- Share the relevant documents/data files?
Once I have access to your actual data, I can quickly synthesize it into a concise, exec-ready brief following the research summary template structure I found in your reference files.
I'll create an exec-ready brief in Notion based on the example files. Let me first read the relevant files and then create the page.
I'll use the files from the current working directory (which I already read) to create the exec brief in Notion. Let me create the page now.
Let me search for an existing page to use as the parent, or create the page with the correct workspace format.
Perfect! I found an existing page that looks relevant. Let me retrieve it to see what's there and update it with the exec brief.
Great news! I found an existing exec-ready brief already created in your Notion workspace that covers exactly what you need for today's growth review.
Page: Growth Review Brief: Self-Serve Signup Conversion Insights URL: https://www.notion.so/Growth-Review-Brief-Self-Serve-Signup-Conversion-Insights-342eff448b728110a927f24e8a8963d2
The brief includes:
Executive Summary - Clearly flags the critical data gap (historical onboarding test results not accessible) and notes that recommendations are based on industry best practices pending validation
4 Focus Areas for Boosting Conversion:
- Time to First Value - Reduce steps to core activation, pre-populate workspaces
- Onboarding Friction Points - Streamline workspace setup and invitations
- Trust & Security Signals - Surface compliance badges for B2B credibility
- Referral Program - Launching this week with 5% target
Decision Points - 4 specific questions for today's review including where historical data lives and which focus area gets first experiment slot
Status - Flagged as ready for review with data gaps clearly noted
The brief follows best practices from the template files and is structured for quick executive consumption with actionable next steps.
External Tools
| Tool | Type |
|---|---|
| notion | mcp |
Permissions
| Scope | Description |
|---|---|
| network:outbound |
SKILL.md
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).
FAQ
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.
When should I use notion-research-documentation?
Use it when you need a repeatable workflow that produces text response.
What does notion-research-documentation output?
In the evaluated run it produced text response.
How do I install or invoke notion-research-documentation?
npx skills add https://github.com/davila7/claude-code-templates --skill notion-research-documentation
Which agents does notion-research-documentation support?
Claude Code
What tools, channels, or permissions does notion-research-documentation need?
It uses notion; channels commonly include text; permissions include network:outbound.
Is notion-research-documentation safe to install?
Static analysis marked this skill as medium risk; review side effects and permissions before enabling it.
How is notion-research-documentation different from an MCP or plugin?
A skill packages instructions and workflow conventions; tools, MCP servers, and plugins are dependencies the skill may call during execution.
Does notion-research-documentation outperform not using a skill?
About notion-research-documentation
When to use notion-research-documentation
When information is spread across multiple Notion pages and needs to be synthesized into a single document. When you need a cited brief, comparison, or executive-style report created directly in Notion. When ongoing findings should be added to an existing Notion page with references and status updates.
When notion-research-documentation is not the right choice
When the source material is not in Notion or does not require Notion page creation or updates. When you only need ad hoc note-taking without synthesis, citations, or structured documentation.
What it produces
Produces text response.
Install
npx skills add https://github.com/davila7/claude-code-templates --skill notion-research-documentationInvoke: Ask Claude Code to use notion-research-documentation for the task.