tavily-ai/tavily-research
skills/tavily-research/SKILL.md
Conduct comprehensive AI-powered research with citations via the Tavily CLI. Use this skill when the user wants deep research, a detailed report, a comparison, market analysis, literature review, or says "research", "investigate", "analyze in depth", "compare X vs Y", "what does the market look like for", or needs multi-source synthesis with explicit citations. Returns a structured report grounded in web sources. Takes 30-120 seconds. For quick fact-finding, use tavily-search instead.
$ install --global
skillsauthnpx skillsauth add tavily-ai/skills tavily-researchInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 15, 2026, 5:04 AM4.3s1 file scanned
SKILL.md
- name:
- tavily-research
- description:
- |
- allowed-tools:
- Bash(tvly *)
tavily research
AI-powered deep research that gathers sources, analyzes them, and produces a cited report. Takes 30-120 seconds.
Before running any command
If tvly is not found on PATH, install it first:
curl -fsSL https://cli.tavily.com/install.sh | bash && tvly login
Do not skip this step or fall back to other tools.
See tavily-cli for alternative install methods and auth options.
When to use
- You need comprehensive, multi-source analysis
- The user wants a comparison, market report, or literature review
- Quick searches aren't enough — you need synthesis with citations
- Step 5 in the workflow: search → extract → map → crawl → research
Quick start
# Basic research (waits for completion)
tvly research "competitive landscape of AI code assistants"
# Pro model for comprehensive analysis
tvly research "electric vehicle market analysis" --model pro
# Stream results in real-time
tvly research "AI agent frameworks comparison" --stream
# Save report to file
tvly research "fintech trends 2025" --model pro -o fintech-report.md
# JSON output for agents
tvly research "quantum computing breakthroughs" --json
Options
| Option | Description |
|--------|-------------|
| --model | mini, pro, or auto (default) |
| --stream | Stream results in real-time |
| --no-wait | Return request_id immediately (async) |
| --output-schema | Path to JSON schema for structured output |
| --citation-format | numbered, mla, apa, chicago |
| --poll-interval | Seconds between checks (default: 10) |
| --timeout | Max wait seconds (default: 600) |
| -o, --output | Save output to file |
| --json | Structured JSON output |
Model selection
| Model | Use for | Speed |
|-------|---------|-------|
| mini | Single-topic, targeted research | ~30s |
| pro | Comprehensive multi-angle analysis | ~60-120s |
| auto | API chooses based on complexity | Varies |
Rule of thumb: "What does X do?" → mini. "X vs Y vs Z" or "best way to..." → pro.
Async workflow
For long-running research, you can start and poll separately:
# Start without waiting
tvly research "topic" --no-wait --json # returns request_id
# Check status
tvly research status <request_id> --json
# Wait for completion
tvly research poll <request_id> --json -o result.json
Tips
- Research takes 30-120 seconds — use
--streamto see progress in real-time. - Use
--model profor complex comparisons or multi-faceted topics. - Use
--output-schemato get structured JSON output matching a custom schema. - For quick facts, use
tvly searchinstead — research is for deep synthesis. - Read from stdin:
echo "query" | tvly research - --json
See also
- tavily-search — quick web search for simple lookups
- tavily-crawl — bulk extract from a site for your own analysis
Related Skills
tavily-ai/tavily-search
tools
VerifiedTrustedCommunity
Search the web with LLM-optimized results via the Tavily CLI. Use this skill when the user wants to search the web, find articles, look up information, get recent news, discover sources, or says "search for", "find me", "look up", "what's the latest on", "find articles about", or needs current information from the internet. Returns relevant results with content snippets, relevance scores, and metadata — optimized for LLM consumption. Supports domain filtering, time ranges, and multiple search depths.
209SKILL.mdUpdated Apr 15, 2026
tavily-ai/tavily-map
tools
VerifiedTrustedCommunity
Discover and list all URLs on a website without extracting content, via the Tavily CLI. Use this skill when the user wants to find a specific page on a large site, list all URLs, see the site structure, find where something is on a domain, or says "map the site", "find the URL for", "what pages are on", "list all pages", or "site structure". Faster than crawling — returns URLs only. Essential when you know the site but not the exact page. Combine with extract for targeted content retrieval.
209SKILL.mdUpdated Apr 15, 2026
tavily-ai/tavily-extract
tools
VerifiedTrustedCommunity
Extract clean markdown or text content from specific URLs via the Tavily CLI. Use this skill when the user has one or more URLs and wants their content, says "extract", "grab the content from", "pull the text from", "get the page at", "read this webpage", or needs clean text from web pages. Handles JavaScript-rendered pages, returns LLM-optimized markdown, and supports query-focused chunking for targeted extraction. Can process up to 20 URLs in a single call.
209SKILL.mdUpdated Apr 15, 2026
tavily-ai/tavily-dynamic-search
development
VerifiedTrustedCommunity
Programmatic web search with context isolation. Use this skill for any research task where you need to search the web, filter results, and extract specific information — without polluting your context window with raw HTML and boilerplate. This is the default skill for web research. Triggered by "search for", "look up", "find", "research", "what's the latest on", or any query that requires current web information. Also use when asked to "search and filter", "find the important parts", or "extract the key details" — any case where the user wants curated, noise-free content.
209SKILL.mdUpdated Apr 15, 2026