tavily-research · tavily-ai, tasks — Claude Code skill: market and technology research
tavily-research — a skill for Claude Code and other platforms that gathers and weighs info from multiple sources. It triggers when performing in-depth analysis of markets, tech, or trends.
MIT 25,100 installs ★ 497 updated 2026-10-23
npx skills add tavily-ai/skills --skill tavily-research -a claude-codeWhat tavily-research does
This skill automates complex research when an answer requires synthesizing data from various locations. It splits a broad request into subtopics, runs parallel searches, and compiles findings into a structured report.
The tool creates research_notes/ and reports/ directories in the working folder. When using subagents, it delegates tasks for each subtopic following guidelines in references/researcher.md. To update an existing report, it focuses only on new or unverified data.
What it helps with
- analyze market trends across multiple criteria
- compare technologies while respecting user constraints
- review literature for broad topics
- perform deep investigations on research requests
Example prompts for the agent
- Analyze the current cloud database market using 2024 reports.
- Compare performance of these three frameworks based on documentation and benchmarks.
- Research architectural shifts using
tavily-research.
How to install tavily-research
1Skills CLI (Vercel)
npx skills add tavily-ai/skills --skill tavily-research -a claude-code2Manually: put the files in place
~/.claude/skills/tavily-research/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/tavily-research/
1Skills CLI (Vercel)
npx skills add tavily-ai/skills --skill tavily-research -a codex2Manually: put the files in place
.agents/skills/tavily-research/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add tavily-ai/skills --skill tavily-research -a cursor2Manually: put the files in place
.cursor/skills/tavily-research/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install tavily-ai/skills skills/tasks/tavily-research2Manually: put the files in place
.github/skills/tavily-research/SKILL.md1Skills CLI (Vercel)
npx skills add tavily-ai/skills --skill tavily-research -a gemini-cli2Platform CLI
gemini skills install https://github.com/tavily-ai/skills --path skills/tasks/tavily-researchManually: put the files in place
.devin/skills/tavily-research/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add tavily-ai/skills --skill tavily-research -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about tavily-research
How to install tavily-research in Claude Code?
Run npx skills add tavily-ai/skills --skill tavily-research -a claude-code. Configuration files will be created at ~/.claude/skills/tavily-research/SKILL.md.
What does tavily-research do?
It researches complex topics across multiple sources, segments them into subtopics, and generates a comprehensive report.
How does tavily-research differ from standard search?
A standard tavily-search finds a single fact or answer. tavily-research constructs an answer from many sources when a question demands thorough analysis.
Source text
SKILL.md · MIT
---
name: tavily-research
description: |
Research a topic in depth with Tavily. Use this skill when a question needs many sources gathered and weighed together: analysing a market, policy, technology or trend, comparing options across several criteria, reviewing the literature, or any request to research, investigate or analyze something in depth. A single fact or answer to find, even one with many clues, is a tavily-search task. For one CRM record use tavily-entity, for a table of matches use tavily-list, and for a recurring check use tavily-monitor.
allowed-tools: Bash(tvly *)
---
# Tavily research
Use this when the answer has to be built from many sources. A single fact or
answer to find is a search: follow `tavily-search` instead.
Search and read pages as `tavily-search` describes. Load it only if it isn't
loaded yet.
## Steps
### 1. Ask only when the answer would change the research
Ask when a term has two meanings, the user assumed a place, or a name is two
different entities. Otherwise start.
### 2. Split the question
Split into subtopics that do not overlap and that together cover the question.
Carry the user's limits with every subtopic: dates, places, and what is out of
scope. Use 3 subtopics when you are unsure, 4 for a comparison with separate
criteria, 5 for separate entities, regions or domains, and more only for a
large set.
### 3. Research the subtopics together
**With subagents:** choose a title of 3 to 6 words, create
`research_notes/{title}/` and `reports/` in the working directory, and start
one general-purpose subagent per subtopic in the same turn. Give each the
subtopic, the key questions, the user's limits, the absolute path of its notes
file, and this first step: read `references/researcher.md` at its absolute path
next to this skill.
**On your own:** run each subtopic's searches in parallel, as `tavily-search`
describes, and extract the main sources for each. Keep the findings and their
URLs in your context. Don't write notes files.
### 4. Fill thin parts, then write
Before writing, run another round for any part of the question that would
leave its section thin.
### 5. Write and deliver the answer
Follow `references/report-writer.md`. On your own, write it once, as
your reply. Save it to `reports/{title}.md` only when the user asked for a
file, and then give the path after the report. With subagents, have one agent
write `reports/{title}.md` from the notes, then give the user the full report
in your reply, followed by its path.
If this conversation already produced a report on the subject, build on it:
research only what is new or needs checking again.
© tavily-ai · MIT · tavily-ai/skills
Similar skills
All skills for Science and research →tavily-research by other authors comes first.