bytedance/deer-flow

deep-research

Use for substantial investigations needing current evidence, source comparison, or synthesis across several dimensions.

View source

How to use

  1. Copy the installation command and review the source package before installing it in your own agent environment.
  2. Check the source document for required tools, credentials and supported hosts.
  3. Describe your input and desired deliverable; review the output against the source material.
npx skills add https://github.com/bytedance/deer-flow --skill deep-research

Before you start

  • Installation does not include a model subscription, API allowance or permission to access your files.
  • Repository stars and installation counts describe activity, not an independent quality or security test.
Original skill document

Rendered from the source repository. Headings, examples, code, tables, links, and referenced images are preserved.

Deep Research Skill

Overview

This skill provides a systematic methodology for conducting thorough web research. Use it when the requested claims need external verification; use supplied material and stable knowledge where sufficient.

When to Use This Skill

Consider this skill when depth and external verification are needed:

Research Questions

  • User asks "what is X", "explain X", "research X", "investigate X"
  • User wants to understand a concept, technology, or topic in depth
  • The question requires current, comprehensive information from multiple sources
  • A single web search would be insufficient to answer properly

Content Generation (Pre-research)

  • Creating presentations (PPT/slides)
  • Creating frontend designs or UI mockups
  • Writing articles, reports, or documentation
  • Producing videos or multimedia content
  • Any content that requires real-world information, examples, or current data

Core Principle

Choose effort according to freshness, uncertainty, consequence, and scope. A focused question may be resolved by one authoritative source; broad or disputed claims need independent checks. Stop when requested claims have sufficient support and state remaining gaps.

Research Methodology

Phase 1: Broad Exploration

Start with broad searches to understand the landscape:

  1. Initial Survey: Search for the main topic to understand the overall context
  2. Identify Dimensions: From initial results, identify key subtopics, themes, angles, or aspects that need deeper exploration
  3. Map the Territory: Note different perspectives, stakeholders, or viewpoints that exist

Example:

Topic: "AI in healthcare"
Initial searches:
- "AI healthcare applications 2024"
- "artificial intelligence medical diagnosis"
- "healthcare AI market trends"

Identified dimensions:
- Diagnostic AI (radiology, pathology)
- Treatment recommendation systems
- Administrative automation
- Patient monitoring
- Regulatory landscape
- Ethical considerations

Phase 2: Deep Dive

For each important dimension identified, conduct targeted research:

  1. Specific Queries: Search with precise keywords for each subtopic
  2. Multiple Phrasings: Try different keyword combinations and phrasings
  3. Fetch Full Content: Use web_fetch to read important sources in full, not just snippets
  4. Follow References: When sources mention other important resources, search for those too

Example:

Dimension: "Diagnostic AI in radiology"
Targeted searches:
- "AI radiology FDA approved systems"
- "chest X-ray AI detection accuracy"
- "radiology AI clinical trials results"

Then fetch and read:
- Key research papers or summaries
- Industry reports
- Real-world case studies

Phase 3: Diversity & Validation

Ensure comprehensive coverage by seeking diverse information types:

Information TypePurposeExample Searches
Facts & DataConcrete evidence"statistics", "data", "numbers", "market size"
Examples & CasesReal-world applications"case study", "example", "implementation"
Expert OpinionsAuthority perspectives"expert analysis", "interview", "commentary"
Trends & PredictionsFuture direction"trends 2024", "forecast", "future of"
ComparisonsContext and alternatives"vs", "comparison", "alternatives"
Challenges & CriticismsBalanced view"challenges", "limitations", "criticism"

Phase 4: Synthesis Check

Before proceeding to content generation, verify:

  • [ ] Have I covered the dimensions needed to answer the request?
  • [ ] Have I fetched and read the most important sources in full?
  • [ ] Do I have concrete data, examples, and expert perspectives?
  • [ ] Have I explored both positive aspects and challenges/limitations?
  • [ ] Is my information current and from authoritative sources?

Investigate material evidence gaps; omit irrelevant checklist items and disclose unresolved limits.

Search Strategy Tips

Effective Query Patterns

# Be specific with context
❌ "AI trends"
✅ "enterprise AI adoption trends 2024"

# Include authoritative source hints
"[topic] research paper"
"[topic] McKinsey report"
"[topic] industry analysis"

# Search for specific content types
"[topic] case study"
"[topic] statistics"
"[topic] expert interview"

# Use temporal qualifiers — always use the ACTUAL current year from <current_date>
"[topic] 2026"   # ← replace with real current year, never hardcode a past year
"[topic] latest"
"[topic] recent developments"

Temporal Awareness

For time-sensitive questions, use the actual current date and the requested time range when choosing search filters.

<current_date> gives you the full date: year, month, day, and weekday (e.g. 2026-02-28, Saturday). Use the right level of precision depending on what the user is asking:

User intentTemporal precision neededExample query
"today / this morning / just released"Month + Day"tech news February 28 2026"
"this week"Week range"technology releases week of Feb 24 2026"
"recently / latest / new"Month"AI breakthroughs February 2026"
"this year / trends"Year"software trends 2026"

Rules:

  • When the user asks about "today" or "just released", use month + day + year in your search queries to get same-day results
  • Never drop to year-only when day-level precision is needed — "tech news 2026" will NOT surface today's news
  • Try multiple phrasings: numeric form (2026-02-28), written form (February 28 2026), and relative terms (today, this week) across different queries

❌ User asks "what's new in tech today" → searching "new technology 2026" → misses today's news ✅ User asks "what's new in tech today" → searching "new technology February 28 2026" + "tech news today Feb 28" → gets today's results

When to Use web_fetch

Use web_fetch to read full content when:

  • A search result looks highly relevant and authoritative
  • You need detailed information beyond the snippet
  • The source contains data, case studies, or expert analysis
  • You want to understand the full context of a finding

Iterative Refinement

Research is iterative. After initial searches:

  1. Review what you've learned
  2. Identify gaps in your understanding
  3. Formulate new, more targeted queries
  4. Repeat until you have comprehensive coverage

Quality Bar

Your research is sufficient when you can confidently answer:

  • What are the key facts and data points?
  • What are 2-3 concrete real-world examples?
  • What do experts say about this topic?
  • What are the current trends and future directions?
  • What are the challenges or limitations?
  • What makes this topic relevant or important now?

Common Mistakes to Avoid

  • Stopping before important claims have sufficient evidence
  • ❌ Relying on search snippets without reading full sources
  • ❌ Searching only one aspect of a multi-faceted topic
  • ❌ Ignoring contradicting viewpoints or challenges
  • ❌ Using outdated information when current data exists
  • Presenting unsupported claims as established findings

Output

After completing research, you should have:

  1. A comprehensive understanding of the topic from multiple angles
  2. Specific facts, data points, and statistics
  3. Real-world examples and case studies
  4. Expert perspectives and authoritative sources
  5. Current trends and relevant context

Produce the requested output once its factual claims have adequate support; adapt these phases to the task.

from this repository

More skills

All skills
bytedance
Community

data-analysis

Use this skill when the user uploads Excel (.xlsx/.xls) or CSV files and wants to perform data analysis, generate statistics, create summaries, pivot tables, SQL queries, or any form of structured data exploration. Supports multi-sheet Excel workbooks, aggregation, filtering, joins, and exporting results to CSV/JSON/Markdown.

1h installs
1
GitHub stars
85.3K
Updated
Nov 12
bytedance
Community

web-design-guidelines

Review UI code for Web Interface Guidelines compliance. Use when asked to "review my UI", "check accessibility", "audit design", "review UX", or "check my site against best practices".

1h installs
1
GitHub stars
84.4K
Updated
Oct 26
bytedance
Community

github-deep-research

Conduct multi-round deep research on any GitHub Repo. Use when users request comprehensive analysis, timeline reconstruction, competitive analysis, or in-depth investigation of GitHub. Produces structured markdown reports with executive summaries, chronological timelines, metrics analysis, and Mermaid diagrams. Triggers on Github repository URL or open source projects.

1h installs
1
GitHub stars
84.2K
Updated
Oct 20
bytedance
Community

frontend-design

Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, artifacts, posters, or applications (examples include websites, landing pages, dashboards, React components, HTML/CSS layouts, or when styling/beautifying any web UI). Generates creative, polished code and UI design that avoids generic AI aesthetics.

1h installs
2
GitHub stars
84.2K
Updated
Oct 20