Agent skill

Tavily

by intellectronica in intellectronica/agent-skills

A skill your agent uses for web search, extraction, mapping, crawling, and research via Tavily’s REST API when web searches are needed and no built-in tool is available, or when Tavily’s…

CC0-1.0Auto-check passedProductivity & Automation

Install Tavily

skills CLI

$ npx skills add intellectronica/agent-skills --skill tavily -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI

$ gh skill install intellectronica/agent-skills tavily --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy

$ git clone --depth 1 https://github.com/intellectronica/agent-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/tavily .claude/skills/tavily && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Paste into Claude Code

Install the "tavily" agent skill from https://github.com/intellectronica/agent-skills/tree/main/skills/tavily into .claude/skills/tavily/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "tavily", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/intellectronica/agent-skills/tree/main/skills/tavily

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add intellectronica/agent-skills --skill tavily -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install intellectronica/agent-skills tavily --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/intellectronica/agent-skills.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/tavily .agents/skills/tavily && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "tavily" agent skill from https://github.com/intellectronica/agent-skills/tree/main/skills/tavily into .agents/skills/tavily/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "tavily", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add intellectronica/agent-skills --skill tavily -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install intellectronica/agent-skills tavily --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/intellectronica/agent-skills.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/tavily .cursor/skills/tavily && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "tavily" agent skill from https://github.com/intellectronica/agent-skills/tree/main/skills/tavily into .cursor/skills/tavily/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "tavily", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/intellectronica/agent-skills.git --path skills/tavily

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add intellectronica/agent-skills --skill tavily -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install intellectronica/agent-skills tavily --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/intellectronica/agent-skills.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/tavily .gemini/skills/tavily && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "tavily" agent skill from https://github.com/intellectronica/agent-skills/tree/main/skills/tavily into .gemini/skills/tavily/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "tavily", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install intellectronica/agent-skills tavily

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add intellectronica/agent-skills --skill tavily -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/intellectronica/agent-skills.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/tavily .github/skills/tavily && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "tavily" agent skill from https://github.com/intellectronica/agent-skills/tree/main/skills/tavily into .github/skills/tavily/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "tavily", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add intellectronica/agent-skills --skill tavily -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install intellectronica/agent-skills tavily --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/intellectronica/agent-skills.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/tavily .opencode/skills/tavily && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "tavily" agent skill from https://github.com/intellectronica/agent-skills/tree/main/skills/tavily into .opencode/skills/tavily/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "tavily", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: tavily
GitHub stars: 295
Token cost: ~1.8k tokens
SKILL.md length: 556 words
Files: 1
Skills in repo: 21
Repo updated: Apr 25, 2026
First seen: Oct 7, 2026
Licence: CC0-1.0

At a glance

A skill your agent uses for web search, extraction, mapping, crawling, and research via Tavily’s REST API when web searches are needed and no built-in tool is available, or when Tavily’s…

Works in 4 steps: search → POST /search → extract → POST /extract → map → POST /map → …
Research via Tavilys REST API when web searches are needed and no built-in tool is available
SKILL.md covers Purpose, When to Use, Required Environment and Base URL and Auth, plus 4 more sections
Calls curl; reaches api.tavily.com and docs.tavily.com; needs TAVILY_API_KEY

What it does

Tavily is an agent skill from intellectronica/agent-skills. Use this skill for web search, extraction, mapping, crawling, and research via Tavily’s REST API when web searches are needed and no built-in tool is available, or when Tavily’s LLM-friendly format is beneficial.

Its SKILL.md is about 1.8k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Productivity & Automation, covering Web search. It works with Tavily. The repository describes itself as: @intellectronica's agent skills. The licence is CC0-1.0.

When your agent uses it

Research via Tavilys REST API when web searches are needed and no built-in tool is available
Tavilys LLM-friendly format is beneficial

Example prompts

“/tavily”

Requirements

Python 3
A credential in TAVILY_API_KEY

Workflow steps

4 steps, taken from the step headings in SKILL.md.

search → POST /search
extract → POST /extract
map → POST /map
crawl → POST /crawl

What it can do on your machine

Read from SKILL.md and the folder at commit 9b0e00a. It shows what the files ask for, not the result of running them.

Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
- curl
From the folder's file list and the shell code blocks in SKILL.md.
Network
Hosts in commands or code, which the agent is likely to contact:
- api.tavily.com
- docs.tavily.com
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names these keys or tokens, usually read from environment variables:
- TAVILY_API_KEY
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Tavily loads about 1.8k tokens when it runs. Until then it costs about 55 tokens; SKILL.md has 556 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~55
When it runs · the whole SKILL.md, loaded when a task matches: ~1.8k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from intellectronica/agent-skills at commit 9b0e00a, republished under its CC0-1.0 licence (© intellectronica). 556 words, ~1,817 tokens.

Download SKILL.mdSave it as .claude/skills/tavily/SKILL.md (or your agent's skills folder).

name: tavily
description: Use this skill for web search, extraction, mapping, crawling, and research via Tavily’s REST API when web searches are needed and no built-in tool is available, or when Tavily’s LLM-friendly format is beneficial.

Tavily

Purpose

Provide a curl-based interface to Tavily’s REST API for web search, extraction, mapping, crawling, and optional research. Return structured results suitable for LLM workflows and multi-step investigations.

When to Use

Use when a task needs live web information, site extraction, mapping, or crawling.
Use when web searches are needed and no built-in tool is available, or when Tavily’s LLM-friendly output (summaries, chunks, sources, citations) is beneficial.
Use when a task requires structured search results, extraction, or site discovery from Tavily.

Required Environment

Require TAVILY_API_KEY in the environment.
If TAVILY_API_KEY is missing, prompt the user to provide the API key before proceeding.

Base URL and Auth

Base URL: https://api.tavily.com
Authentication: Authorization: Bearer $TAVILY_API_KEY
Content type: Content-Type: application/json
Optional project tracking: add X-Project-ID: <project-id> if project attribution is needed.

Tool Mapping (Tavily REST)

1) search → POST /search

Use for web search with optional answer and content extraction.

Recommended minimal request:

bash

curl -sS -X POST "https://api.tavily.com/search" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TAVILY_API_KEY" \
  -d '{
    "query": "<query>",
    "search_depth": "basic",
    "max_results": 5,
    "include_answer": true,
    "include_raw_content": false,
    "include_images": false
  }'

Key parameters (all optional unless noted):

query (required): search text
search_depth: basic | advanced | fast | ultra-fast
chunks_per_source: 1–3 (advanced only)
max_results: 0–20
topic: general | news | finance
time_range: day|week|month|year|d|w|m|y
start_date, end_date: YYYY-MM-DD
include_answer: false | true | basic | advanced
include_raw_content: false | true | markdown | text
include_images: boolean
include_image_descriptions: boolean
include_favicon: boolean
include_domains, exclude_domains: string arrays
country: country name (general topic only)
auto_parameters: boolean
include_usage: boolean

Expected response fields:

answer (if requested), results[] with title, url, content, score, raw_content (optional), favicon (optional)
response_time, usage, request_id

2) extract → POST /extract

Use for extracting content from specific URLs.

bash

curl -sS -X POST "https://api.tavily.com/extract" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TAVILY_API_KEY" \
  -d '{
    "urls": ["https://example.com/article"],
    "query": "<optional intent for reranking>",
    "chunks_per_source": 3,
    "extract_depth": "basic",
    "format": "markdown",
    "include_images": false,
    "include_favicon": false
  }'

Key parameters:

urls (required): array of URLs
query: rerank chunks by intent
chunks_per_source: 1–5 (only when query provided)
extract_depth: basic | advanced
format: markdown | text
timeout: 1–60 seconds
include_usage: boolean

Expected response fields:

results[] with url, raw_content, images, favicon
failed_results[], response_time, usage, request_id

3) map → POST /map

Use for generating a site map (URL discovery only).

bash

curl -sS -X POST "https://api.tavily.com/map" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TAVILY_API_KEY" \
  -d '{
    "url": "https://docs.tavily.com",
    "max_depth": 1,
    "max_breadth": 20,
    "limit": 50,
    "allow_external": true
  }'

Key parameters:

url (required)
instructions: natural language guidance (raises cost)
max_depth: 1–5
max_breadth: 1+
limit: 1+
select_paths, select_domains, exclude_paths, exclude_domains: arrays of regex strings
allow_external: boolean
timeout: 10–150 seconds
include_usage: boolean

Expected response fields:

base_url, results[] (list of URLs), response_time, usage, request_id

Show full SKILL.md (219 more words)Show less

4) crawl → POST /crawl

Use for site traversal with built-in extraction.

bash

curl -sS -X POST "https://api.tavily.com/crawl" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TAVILY_API_KEY" \
  -d '{
    "url": "https://docs.tavily.com",
    "instructions": "Find all pages about the Python SDK",
    "max_depth": 1,
    "max_breadth": 20,
    "limit": 50,
    "extract_depth": "basic",
    "format": "markdown",
    "include_images": false
  }'

Key parameters:

url (required)
instructions: optional; raises cost and enables chunks_per_source
chunks_per_source: 1–5 (only with instructions)
max_depth, max_breadth, limit: same as map
extract_depth: basic | advanced
format: markdown | text
include_images, include_favicon, allow_external
timeout: 10–150 seconds
include_usage: boolean

Expected response fields:

base_url, results[] with url, raw_content, favicon
response_time, usage, request_id

Optional Research Workflow (Deep Investigation)

Use when a query needs multi-step analysis and citations.

create research task → POST /research

bash

curl -sS -X POST "https://api.tavily.com/research" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TAVILY_API_KEY" \
  -d '{
    "input": "<research question>",
    "model": "auto",
    "stream": false,
    "citation_format": "numbered"
  }'

Expected response fields:

request_id, created_at, status (pending), input, model, response_time

get research status → GET /research/{request_id}

bash

curl -sS -X GET "https://api.tavily.com/research/<request_id>" \
  -H "Authorization: Bearer $TAVILY_API_KEY"

Expected response fields:

status: completed
content: report text or structured object
sources[]: { title, url, favicon }

streaming research (SSE)

Set "stream": true in the POST body and use curl with -N to stream events:

bash

curl -N -X POST "https://api.tavily.com/research" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TAVILY_API_KEY" \
  -d '{"input":"<question>","stream":true,"model":"pro"}'

Handle SSE events (tool calls, tool responses, content chunks, sources, done).

Usage Notes

Treat search, extract, map, and crawl as the primary endpoints for discovery and content retrieval.
Return structured results with URLs, titles, and summaries for easy downstream use.
Default to conservative parameters (search_depth: basic, max_results: 5) unless deeper recall is needed.
Reuse consistent request bodies across calls to keep results predictable.

Error Handling

If any request returns 401/403, prompt for or re-check TAVILY_API_KEY.
If timeouts occur, reduce max_depth/limit or use search_depth: basic.
If responses are too large, lower max_results or chunks_per_source.

Files

Just SKILL.md in skills/tavily of intellectronica/agent-skills.

Open the folder on GitHubat commit 9b0e00a

Compare with similar skills

Tavily next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Tavily compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Tavily this skillintellectronica/agent-skills	295	—	~1.8k	Automated safety check: Pass	CC0-1.0	5 mo ago
Ultimate Searchckckck/UltimateSearchSkill	289	—	~944	Automated safety check: Notes	MIT	6 mo ago
Web SearchEXboys/skilllite	170	2 repos	~1k	Automated safety check: Pass	MIT	15 days ago
Mysearchskernelx/MySearch-Proxy	159	—	~3k	Automated safety check: Notes	None	6 mo ago
Tavilyopenclaw/openclaw	392k	2 repos	~1.2k	Automated safety check: Pass	MIT	today
Web Search Plus Plugin V2robbyczgw-cla/web-search-plus-plugin	101	—	~1.9k	Automated safety check: Notes	MIT	16 days ago

Similar skills

Ultimate Search
ckckck/UltimateSearchSkill
双引擎网络搜索：Grok AI 搜索（实时联网+AI分析）+ Tavily 搜索（结构化结果+网页抓取）. An agent skill from ckckck/UltimateSearchSkill.
289 GitHub stars~944 tokensUpdated 6 mo ago
Productivity & AutomationAuto-check: notes
Web Search
EXboys/skilllite
Web search and content extraction with Tavily and Exa via inference.sh CLI.
170 GitHub starsUsed in 2 repos~1k tokens
Productivity & AutomationAuto-check passed
Mysearch
skernelx/MySearch-Proxy
Install, verify, debug, and use MySearch MCP/Skill. An agent skill from skernelx/MySearch-Proxy.
159 GitHub stars~3k tokensUpdated 6 mo ago
Productivity & AutomationAuto-check: notes
Tavily
openclaw/openclaw
Tavily web search, content extraction, and research tools. An agent skill from openclaw/openclaw.
392k GitHub starsUsed in 2 repos~1.2k tokens
Productivity & AutomationAuto-check passed
Web Search Plus Plugin V2
robbyczgw-cla/web-search-plus-plugin
OpenClaw plugin for source-only Routing v2 multi-provider search, completion-order Research with quality quorum and attributed provenance, heading-aware extraction spans, Tavily-first extraction…
101 GitHub stars~1.9k tokensUpdated 16 days ago
Productivity & AutomationAuto-check: notes
Tavily Hikari Best Practices
IvanLi-CN/tavily-hikari
Guide agents to use Tavily Hikari safely through tvly-hikari.
362 GitHub stars~287 tokensUpdated 3 days ago
Productivity & AutomationAuto-check passed

Questions about Tavily

What does Tavily do?

A skill your agent uses for web search, extraction, mapping, crawling, and research via Tavily’s REST API when web searches are needed and no built-in tool is available, or when Tavily’s…. Tavily is an agent skill from intellectronica/agent-skills. Use this skill for web search, extraction, mapping, crawling, and research via Tavily’s REST API when web searches are needed and no built-in tool is available, or when Tavily’s LLM-friendly format is beneficial.

When should I use Tavily?

Tavily fits situations like: research via Tavilys REST API when web searches are needed and no built-in tool is available; tavilys LLM-friendly format is beneficial.

How do I install Tavily in Claude Code?

Run `npx skills add intellectronica/agent-skills --skill tavily -a claude-code`. Or copy the skill folder (skills/tavily in intellectronica/agent-skills) into .claude/skills/tavily in your project. Claude Code loads it when a task matches its description.

How do I install Tavily in Codex?

Run `npx skills add intellectronica/agent-skills --skill tavily -a codex`. Or copy the skill folder (skills/tavily in intellectronica/agent-skills) into .agents/skills/tavily in your project. Codex loads it when a task matches its description.

Can I use Tavily in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add intellectronica/agent-skills --skill tavily -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/tavily, .gemini/skills/tavily, .github/skills/tavily and .opencode/skills/tavily in your project.

What does Tavily need to run?

Going by SKILL.md and its folder, Tavily needs the command-line tools its instructions call (curl) and credentials named TAVILY_API_KEY. Our summary lists: Python 3; A credential in TAVILY_API_KEY.

Does Tavily access the network?

SKILL.md names 2 domains. In commands or code: api.tavily.com and docs.tavily.com; the agent is likely to contact these when it follows the instructions. This is read from the text; nothing was executed.

Is Tavily safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Tavily use?

Tavily is published under the CC0-1.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Tavily use?

About 1.8k tokens (SKILL.md is roughly 7.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Tavily?

Skills that share tags, products or a category with Tavily: Ultimate Search (ckckck/UltimateSearchSkill, 289 stars), Web Search (EXboys/skilllite, 170 stars), Mysearch (skernelx/MySearch-Proxy, 159 stars) and Tavily (openclaw/openclaw, 392k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Tavily?

intellectronica (a GitHub user) maintains it in intellectronica/agent-skills, which has 295 GitHub stars. The repository holds 21 skills in this directory. The repository was last updated on April 25, 2026.

Source: intellectronica/agent-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Install Tavily

Facts

At a glance

What it does

When your agent uses it

Example prompts

Requirements

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

Tavily

Purpose

When to Use

Required Environment

Base URL and Auth

Tool Mapping (Tavily REST)

1) search → POST /search

2) extract → POST /extract

3) map → POST /map

4) crawl → POST /crawl

Optional Research Workflow (Deep Investigation)

create research task → POST /research

get research status → GET /research/{request_id}

streaming research (SSE)

Usage Notes

Error Handling

Files

Compare with similar skills

Similar skills

More from intellectronica/agent-skills

Related

Questions about Tavily