$npx -y skills add langchain-ai/deepagents --skill web-researchSearches multiple web sources, synthesizes findings, and produces cited research reports using delegated subagents. Use when the user asks to research a topic online, search the web, look something up, find current information, compare options, or produce a research report.
| 1 | # Web Research Skill |
| 2 | |
| 3 | ## Research Process |
| 4 | |
| 5 | ### Step 1: Create and Save Research Plan |
| 6 | |
| 7 | Before delegating to subagents, you MUST: |
| 8 | |
| 9 | 1. **Create a research folder** - Organize all research files in a dedicated folder relative to the current working directory: |
| 10 | ``` |
| 11 | mkdir research_[topic_name] |
| 12 | ``` |
| 13 | This keeps files organized and prevents clutter in the working directory. |
| 14 | |
| 15 | 2. **Analyze the research question** - Break it down into distinct, non-overlapping subtopics |
| 16 | |
| 17 | 3. **Write a research plan file** - Use the `write_file` tool to create `research_[topic_name]/research_plan.md` containing: |
| 18 | - The main research question |
| 19 | - 2-5 specific subtopics to investigate |
| 20 | - Expected information from each subtopic |
| 21 | - How results will be synthesized |
| 22 | |
| 23 | **Planning Guidelines:** |
| 24 | - **Simple fact-finding**: 1-2 subtopics |
| 25 | - **Comparative analysis**: 1 subtopic per comparison element (max 3) |
| 26 | - **Complex investigations**: 3-5 subtopics |
| 27 | |
| 28 | ### Step 2: Delegate to Research Subagents |
| 29 | |
| 30 | For each subtopic in your plan: |
| 31 | |
| 32 | 1. **Use the `task` tool** to spawn a research subagent with: |
| 33 | - Clear, specific research question (no acronyms) |
| 34 | - Instructions to write findings to a file: `research_[topic_name]/findings_[subtopic].md` |
| 35 | - Budget: 3-5 web searches maximum |
| 36 | |
| 37 | 2. **Run up to 3 subagents in parallel** for efficient research |
| 38 | |
| 39 | **Subagent Instructions Template:** |
| 40 | ``` |
| 41 | Research [SPECIFIC TOPIC]. Use the web_search tool to gather information. |
| 42 | After completing your research, use write_file to save your findings to research_[topic_name]/findings_[subtopic].md. |
| 43 | Include key facts, relevant quotes, and source URLs. |
| 44 | Use 3-5 web searches maximum. |
| 45 | ``` |
| 46 | |
| 47 | ### Step 3: Synthesize Findings |
| 48 | |
| 49 | After all subagents complete: |
| 50 | |
| 51 | 1. **Review the findings files** that were saved locally: |
| 52 | - First run `list_files research_[topic_name]` to see what files were created |
| 53 | - Then use `read_file` with the **file paths** (e.g., `research_[topic_name]/findings_*.md`) |
| 54 | - **Important**: Use `read_file` for LOCAL files only, not URLs |
| 55 | |
| 56 | 2. **Synthesize the information** - Create a comprehensive response that: |
| 57 | - Directly answers the original question |
| 58 | - Integrates insights from all subtopics |
| 59 | - Cites specific sources with URLs (from the findings files) |
| 60 | - Identifies any gaps or limitations |
| 61 | |
| 62 | 3. **Write final report** (optional) - Use `write_file` to create `research_[topic_name]/research_report.md` if requested |
| 63 | |
| 64 | **Note**: If you need to fetch additional information from URLs, use the `fetch_url` tool, not `read_file`. |
| 65 | |
| 66 | ## Best Practices |
| 67 | |
| 68 | - **Plan before delegating** - Always write research_plan.md first |
| 69 | - **Clear subtopics** - Ensure each subagent has distinct, non-overlapping scope |
| 70 | - **File-based communication** - Have subagents save findings to files, not return them directly |
| 71 | - **Systematic synthesis** - Read all findings files before creating final response |
| 72 | - **Stop appropriately** - Don't over-research; 3-5 searches per subtopic is usually sufficient |