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.
Savant verdict: Review advised
Security analysis or source-hub review identified patterns requiring attention.
Live evaluation
40overall
35quality
19compliance
100grounding
22actionability
44efficiency
Why this score may understate the skillThe live evaluation is a chat-only run: the model follows the skill's instructions but can't execute its scripts, call tools or reach the network.
- Expects tools, MCP servers, installs or network access that a chat-only run doesn't have.
- 6 reference files were too large to include in the run's context.
0 pass · 0 investigate · 5 fail across 5 cases. Independent evaluation accepted 5 of 20 model-drafted cases. Drafted and run by nvidia/nemotron-3-super-120b-a12b, validated and scored by jev-latest.
- Research our current remote work policy and create a quick brief for the leadership team meeting tomorrow.positive case · fail
- Compare the three project management tools we've evaluated - Asana, Trello, and Jira - for our engineering team's workflow needs.positive case · fail
- Research the Q3 marketing campaign performance and create a research summary document for the marketing team.positive case · fail
- Send an email to the team summarizing the meeting notes from yesterday.negative case · fail
- Update our customer database with the latest contact information from the CRM export.negative case · fail
Security assessment
Risk score
28/100
Recommendation
CAUTION
Severity
MEDIUM
Savant decision
Review advised
The assessment recommends caution with a risk score of 20/100 or more; review its findings before use. Static security analysis completed.
2 patterns found
- analysis-evasion: examples/competitor-analysis.md (partial)high · SKILL.md:59 · Referenced artifact was not completely inspected
- Excessive Agency: NOT LIMITED TOlow · LICENSE.txt:7 · Skill's behavior or capabilities extend beyond its stated purpose. Scope creep allows an agent to perform actions unrelated to its documented functionality, increasing the attack surface.
SKILL.md
--- 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`. ## 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. ### 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`).