web-research
Scannednpx machina-cli add skill DougTrajano/pydantic-ai-skills/web-research --openclawWeb Research Skill
This skill provides guidance on conducting comprehensive web research. It emphasizes planning, efficient information gathering, and systematic synthesis of findings.
Note: This skill provides a methodology and best practices for web research. It does not include executable scripts or tools beyond what's available in your agent's toolset.
When to Use This Skill
Use this skill when you need to:
- Research complex topics requiring multiple information sources
- Gather and synthesize current information from the web
- Conduct comparative analysis across multiple subjects
- Produce well-sourced research reports with clear citations
Research Process
Step 1: Create and Save Research Plan
Before conducting research:
-
Analyze the research question - Break it down into distinct, non-overlapping subtopics
-
Create a research plan - Determine:
- The main research question
- 2-5 specific subtopics to investigate
- Expected information from each subtopic
- How results will be synthesized
Planning Guidelines:
- Simple fact-finding: 1-2 subtopics
- Comparative analysis: 1 subtopic per comparison element (max 3)
- Complex investigations: 3-5 subtopics
Step 2: Gather Information
For each subtopic in your plan:
-
Use available web search tools to gather information with:
- Clear, specific search queries
- Target: 3-5 searches per subtopic maximum
-
Organize findings as you gather them
Step 3: Synthesize Findings
After gathering information:
-
Review all collected information from your searches
-
Synthesize the information - Create a comprehensive response that:
- Directly answers the original question
- Integrates insights from all subtopics
- Cites specific sources with URLs
- Identifies any gaps or limitations
Best Practices
- Plan before searching - Understand what you need to find and organize your approach
- Clear subtopics - Ensure each search has a distinct, non-overlapping scope
- Systematic synthesis - Review all findings before creating final response
- Stop appropriately - Don't over-research; 3-5 searches per subtopic is usually sufficient
- Cite sources - Always include URLs to sources in your final response
Source
git clone https://github.com/DougTrajano/pydantic-ai-skills/blob/main/examples/skills/web-research/SKILL.mdView on GitHub Overview
This skill provides guidance on conducting comprehensive web research. It emphasizes planning, efficient information gathering, and systematic synthesis of findings.
How This Skill Works
Start by creating a research plan that breaks the question into subtopics and defines expected information. Then gather information with clear, specific search queries and organize findings. Finally, synthesize all sources into a well-cited response, identifying gaps.
When to Use It
- Research complex topics requiring multiple information sources
- Gather and synthesize current information from the web
- Conduct comparative analysis across multiple subjects
- Produce well-sourced research reports with clear citations
- Identify gaps and limitations in available information
Quick Start
- Step 1: Create and Save Research Plan - Analyze the research question, break it down into subtopics, and plan expected information and synthesis.
- Step 2: Gather Information - For each subtopic, use web search tools with clear, specific queries and target 3-5 searches per subtopic; organize findings.
- Step 3: Synthesize Findings - Review all collected information, synthesize into a comprehensive, source-cited response, and identify gaps.
Best Practices
- Plan before searching
- Clear subtopics with non-overlapping scopes
- Systematic synthesis of findings before finalizing
- Stop appropriately; 3-5 searches per subtopic is usually sufficient
- Cite sources with URLs in the final report
Example Use Cases
- Prepare a literature-style briefing on a topic requiring 3 subtopics and 3-5 searches per subtopic, with citations
- Compare regulatory frameworks across regions using multiple sources and present side-by-side citations
- Assemble a market analysis report by synthesizing data from 5 sources with clear URLs
- Analyze a technology trend by collecting and evaluating information from several sources and highlighting consistencies and discrepancies
- Produce a policy recommendation backed by well-sourced evidence and direct URLs to sources