{"id":24809,"plugin_id":"plugin_asdk_app_69c18c28f1188191bf5b8445c4ab0a2e","kind":"skill","collection_source":null,"comparison_source":null,"observed_at":"2026-09-30T23:18:41.025Z","digest":"e306e4d47f2bc92273b35b9132dac6b4ce7885dc3a571c7898ef603104d3ed01","against":5166,"payload":{"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.","included_files":[{"relative_path":"LICENSE.txt","size_in_bytes":1057},{"relative_path":"agents/openai.yaml","size_in_bytes":312},{"relative_path":"assets/notion-small.svg","size_in_bytes":1561},{"relative_path":"assets/notion.png","size_in_bytes":8526},{"relative_path":"evaluations/README.md","size_in_bytes":4264},{"relative_path":"evaluations/basic-research.json","size_in_bytes":1716},{"relative_path":"evaluations/research-to-database.json","size_in_bytes":1659},{"relative_path":"examples/competitor-analysis.md","size_in_bytes":8271},{"relative_path":"examples/market-research.md","size_in_bytes":2181},{"relative_path":"examples/technical-investigation.md","size_in_bytes":6504},{"relative_path":"examples/trip-planning.md","size_in_bytes":3872},{"relative_path":"reference/advanced-search.md","size_in_bytes":4592},{"relative_path":"reference/citations.md","size_in_bytes":5149},{"relative_path":"reference/comparison-format.md","size_in_bytes":869},{"relative_path":"reference/comparison-template.md","size_in_bytes":910},{"relative_path":"reference/comprehensive-report-format.md","size_in_bytes":1075},{"relative_path":"reference/comprehensive-report-template.md","size_in_bytes":1269},{"relative_path":"reference/format-selection-guide.md","size_in_bytes":2797},{"relative_path":"reference/quick-brief-format.md","size_in_bytes":766},{"relative_path":"reference/quick-brief-template.md","size_in_bytes":472},{"relative_path":"reference/research-summary-format.md","size_in_bytes":840},{"relative_path":"reference/research-summary-template.md","size_in_bytes":1151}],"skill_md_contents":"---\nname: notion-research-documentation\ndescription: Research across Notion and synthesize into structured documentation; use when gathering info from multiple Notion sources to produce briefs, comparisons, or reports with citations.\nmetadata:\n  short-description: Research Notion content and produce briefs/reports\n---\n\n# Research & Documentation\n\nPull relevant Notion pages, synthesize findings, and publish clear briefs or reports (with citations and links to sources).\n\n## Quick start\n1) Find sources with `Notion:search` using targeted queries; confirm scope with the user.\n2) Fetch pages via `Notion:fetch`; note key sections and capture citations (`reference/citations.md`).\n3) Choose output format (brief, summary, comparison, comprehensive report) using `reference/format-selection-guide.md`.\n4) Draft in Notion with `Notion:notion-create-pages` using the matching template (quick, summary, comparison, comprehensive).\n5) Link sources and add a references/citations section; update as new info arrives with `Notion:notion-update-page`.\n\n## Tool-call guardrails\n- Notion tool availability can vary by workspace. If a Notion MCP call returns `Tool <name> not found`, treat that tool as unavailable for the rest of the current task. Do not retry it with different arguments or call it again later; use `Notion:search` and `Notion:fetch` where sufficient.\n- Use one literal search query per `Notion:search` call and include `filters: {}` when no narrower filter is needed.\n- Only fetch Notion page, database, or data-source URLs/IDs. Search results can include external connected-source URLs, which are not valid `Notion:fetch` inputs.\n- Create output pages with an explicit `parent` and a `pages` array.\n- When updating an existing report, fetch it first and use `Notion:notion-update-page` with `update_content`, `properties: {}`, and search-and-replace pairs. For property-only updates, use `update_properties` with `content_updates: []`. The current deployed schema expects both top-level fields even when one is unused. Do not invent insertion-only commands.\n\n## Workflow\n### 0) If Notion tools are unavailable, pause and ask the user to connect the Notion app:\n1. Enable the bundled Notion app for this plugin or session.\n2. Complete the Notion auth flow if prompted.\n3. Start a new session if the tools still do not appear.\n\nAfter the app is connected, finish your answer and tell the user to retry so they can continue with Step 1.\n\n### 1) Gather sources\n- Search first (`Notion:search`); refine queries, and ask the user to confirm if multiple results appear.\n- Fetch relevant pages (`Notion:fetch`), skim for facts, metrics, claims, constraints, and dates.\n- Track each source URL/ID for later citation; prefer direct quotes for critical facts.\n\n### 2) Select the format\n- Quick readout → quick brief.\n- Single-topic dive → research summary.\n- Option tradeoffs → comparison.\n- Deep dive / exec-ready → comprehensive report.\n- See `reference/format-selection-guide.md` for when to pick each.\n\n### 3) Synthesize\n- Outline before writing; group findings by themes/questions.\n- Note evidence with source IDs; flag gaps or contradictions.\n- Keep user goal in view (decision, summary, plan, recommendation).\n\n### 4) Create the doc\n- Pick the matching template in `reference/` (brief, summary, comparison, comprehensive) and adapt it.\n- Create the page with `Notion:notion-create-pages`; include title, summary, key findings, supporting evidence, and recommendations/next steps when relevant.\n- Add citations inline and a references section; link back to source pages.\n\n### 5) Finalize & handoff\n- Add highlights, risks, and open questions.\n- If the user needs follow-ups, create tasks or a checklist in the page; link any task database entries if applicable.\n- Share a short changelog or status using `Notion:notion-update-page` when updating.\n\n## References and examples\n- `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`).\n- `examples/` — end-to-end walkthroughs (e.g., `competitor-analysis.md`, `technical-investigation.md`, `market-research.md`, `trip-planning.md`).\n"},"changes":[{"path":"/included_files","type":"changed","before":[{"relative_path":"assets/notion-small.svg","size_in_bytes":1561},{"relative_path":"assets/notion.png","size_in_bytes":8526},{"relative_path":"evaluations/README.md","size_in_bytes":4264},{"relative_path":"evaluations/basic-research.json","size_in_bytes":1716},{"relative_path":"evaluations/research-to-database.json","size_in_bytes":1659},{"relative_path":"examples/competitor-analysis.md","size_in_bytes":8271},{"relative_path":"examples/market-research.md","size_in_bytes":2181},{"relative_path":"examples/technical-investigation.md","size_in_bytes":6504},{"relative_path":"examples/trip-planning.md","size_in_bytes":3872},{"relative_path":"reference/advanced-search.md","size_in_bytes":4592},{"relative_path":"reference/citations.md","size_in_bytes":5149},{"relative_path":"reference/comparison-format.md","size_in_bytes":869},{"relative_path":"reference/comparison-template.md","size_in_bytes":910},{"relative_path":"reference/comprehensive-report-format.md","size_in_bytes":1075},{"relative_path":"reference/comprehensive-report-template.md","size_in_bytes":1269},{"relative_path":"reference/format-selection-guide.md","size_in_bytes":2797},{"relative_path":"reference/quick-brief-format.md","size_in_bytes":766},{"relative_path":"reference/quick-brief-template.md","size_in_bytes":472},{"relative_path":"reference/research-summary-format.md","size_in_bytes":840},{"relative_path":"reference/research-summary-template.md","size_in_bytes":1151}],"after":[{"relative_path":"LICENSE.txt","size_in_bytes":1057},{"relative_path":"agents/openai.yaml","size_in_bytes":312},{"relative_path":"assets/notion-small.svg","size_in_bytes":1561},{"relative_path":"assets/notion.png","size_in_bytes":8526},{"relative_path":"evaluations/README.md","size_in_bytes":4264},{"relative_path":"evaluations/basic-research.json","size_in_bytes":1716},{"relative_path":"evaluations/research-to-database.json","size_in_bytes":1659},{"relative_path":"examples/competitor-analysis.md","size_in_bytes":8271},{"relative_path":"examples/market-research.md","size_in_bytes":2181},{"relative_path":"examples/technical-investigation.md","size_in_bytes":6504},{"relative_path":"examples/trip-planning.md","size_in_bytes":3872},{"relative_path":"reference/advanced-search.md","size_in_bytes":4592},{"relative_path":"reference/citations.md","size_in_bytes":5149},{"relative_path":"reference/comparison-format.md","size_in_bytes":869},{"relative_path":"reference/comparison-template.md","size_in_bytes":910},{"relative_path":"reference/comprehensive-report-format.md","size_in_bytes":1075},{"relative_path":"reference/comprehensive-report-template.md","size_in_bytes":1269},{"relative_path":"reference/format-selection-guide.md","size_in_bytes":2797},{"relative_path":"reference/quick-brief-format.md","size_in_bytes":766},{"relative_path":"reference/quick-brief-template.md","size_in_bytes":472},{"relative_path":"reference/research-summary-format.md","size_in_bytes":840},{"relative_path":"reference/research-summary-template.md","size_in_bytes":1151}]}],"summary":"Fields changed: 1. /included_files.","summary_kind":"deterministic","summary_metadata":{}}