Agent skill
notion-research-documentation
Searches across your Notion workspace, synthesizes findings from multiple pages, and creates comprehensive research documentation saved as new Notion pages. Turns scattered information into structured reports with proper citations and actionable insights.
Install this agent skill to your Project
npx add-skill https://github.com/refly-ai/skill-to-workflow/tree/main/skills-source/notion/notion-research-documentation
SKILL.md
Research & Documentation
Enables comprehensive research workflows: search for information across your Notion workspace, fetch and analyze relevant pages, synthesize findings, and create well-structured documentation.
Quick Start
When asked to research and document a topic:
- Search for relevant content: Use
Notion:notion-searchto find pages - Fetch detailed information: Use
Notion:notion-fetchto read full page content - Synthesize findings: Analyze and combine information from multiple sources
- Create structured output: Use
Notion:notion-create-pagesto write documentation
Research Workflow
Step 1: Search for relevant information
Use Notion:notion-search with the research topic
Filter by teamspace if scope is known
Review search results to identify most relevant pages
Step 2: Fetch page content
Use Notion:notion-fetch for each relevant page URL
Collect content from all relevant sources
Note key findings, quotes, and data points
Step 3: Synthesize findings
Analyze the collected information:
- Identify key themes and patterns
- Connect related concepts across sources
- Note gaps or conflicting information
- Organize findings logically
Step 4: Create structured documentation
Use the appropriate documentation template (see reference/format-selection-guide.md) to structure output:
- Clear title and executive summary
- Well-organized sections with headings
- Citations linking back to source pages
- Actionable conclusions or next steps
Output Formats
Choose the appropriate format based on request:
Research Summary: See reference/research-summary-format.md Comprehensive Report: See reference/comprehensive-report-format.md Quick Brief: See reference/quick-brief-format.md
Best Practices
- Cast a wide net first: Start with broad searches, then narrow down
- Cite sources: Always link back to source pages using mentions
- Verify recency: Check page last-edited dates for current information
- Cross-reference: Validate findings across multiple sources
- Structure clearly: Use headings, bullets, and formatting for readability
Page Placement
By default, create research documents as standalone pages. If the user specifies:
- A parent page → use
page_idparent - A database → fetch the database first, then use appropriate
data_source_id - A teamspace → create in that context
Advanced Features
Search filtering: See reference/advanced-search.md Citation styles: See reference/citations.md
Common Issues
"No results found": Try broader search terms or different teamspaces "Too many results": Add filters or search within specific pages "Can't access page": User may lack permissions, ask them to verify access
Examples
See examples/ for complete workflow demonstrations:
- examples/market-research.md - Researching market trends
- examples/technical-investigation.md - Technical deep-dive
- examples/competitor-analysis.md - Multi-source synthesis
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
distinctive-frontend-design
Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications. Generates creative, polished code that avoids generic AI aesthetics.
agent-md-generator
交互式生成 GitHub Copilot agents.md 文件的工作流。当用户请求创建代理、构建自定义 Copilot 代理、生成 agents.md 或需要帮助配置 GitHub Copilot 自定义代理时使用。触发短语包括"创建代理"、"生成 agent.md"、"做一个文档代理"、"生成测试代理"等涉及 GitHub Copilot 代理配置的请求。
httpie-api-test
API 接口测试工作流,使用 HTTPie 作为核心工具。当用户需要测试 API 接口、执行接口调用、生成测试报告、管理接口依赖关系、或在项目中建立标准化的接口测试流程时使用此 skill。适用于 RESTful API 测试、接口联调、回归测试等场景。
sdd-development
Specification-Driven Development (SDD) methodology for building software where specifications are executable and drive code generation. Use when users want to: (1) Create feature specifications with /speckit.specify, (2) Generate implementation plans with /speckit.plan, (3) Create executable tasks with /speckit.tasks, (4) Follow test-first, library-first development, or (5) Implement constitutional architecture principles. Essential for structured AI-assisted development workflows.
notebooklm
Use this skill to query your Google NotebookLM notebooks directly from Claude Code for source-grounded, citation-backed answers from Gemini. Browser automation, library management, persistent auth. Drastically reduced hallucinations through document-only responses.
github-actions-ssh-deploy
交互式配置 GitHub Actions 通过 SSH 密钥连接 VPS 的向导。当用户需要设置 GitHub Actions 部署到 VPS、配置 CI/CD SSH 连接、生成部署 workflow 时使用此 skill。通过问答方式收集必要信息后生成完整配置。
Didn't find tool you were looking for?