Agent skill

Tavily Web Search

by allenpeng0705 in allenpeng0705/EnvoyMesh

Searches the web through the Tavily API with LLM-friendly output: clean structured results, optional AI-written answers, domain filters, news mode, images and raw content.

No licenceAuto-check: notesProductivity & Automation

Install Tavily Web Search

skills CLI
$ npx skills add allenpeng0705/EnvoyMesh --skill tavily -a claude-code

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

GitHub CLI
$ gh skill install allenpeng0705/EnvoyMesh 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/allenpeng0705/EnvoyMesh.git skills-src && mkdir -p .claude/skills && cp -r skills-src/apps/node/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/

Facts

Skill name
tavily
GitHub stars
3.1k
Used in
3 other repos
Token cost
~2.5k tokens
SKILL.md length
632 words
Files
6 (incl. scripts, references)
Skills in repo
1
Repo updated
First seen
Licence
None found

At a glance

Searches the web through the Tavily API with LLM-friendly output: clean structured results, optional AI-written answers, domain filters, news mode, images and raw content.

  • Works in 9 steps: Research & Fact-Finding → Current Events → Domain-Specific Research → …
  • Looking up current events with a news-focused search
  • SKILL.md covers Overview, Architecture, Quick Start and Search Modes, plus 4 more sections
  • Runs Python scripts from its folder; calls pip, jq and python3; needs TAVILY_API_KEY

What it does

The bundled `scripts/tavily_search.py` takes a query and returns structured results, with an AI-generated answer summary if requested. Two depths are available: `basic`, a fast mode of roughly one to two seconds suited to quick facts and definitions, and `advanced`, which takes five to ten seconds and suits research, complex topics and cases where several perspectives help. A decision tree in the skill picks between them and favors basic for time-sensitive queries.

Topics can be general, covering all time and broad web content, or news, which looks at the last seven days of news sites and is the choice when a query says latest, recent, current or today. Further options include including or excluding specific domains, adding relevant images and extracting raw page content for deeper analysis. A reference file documents the API, and the API key setup section starts with adding the key to the Clawdbot config.

When your agent uses it

  • Looking up current events with a news-focused search
  • Researching a topic with answer summaries and source links
  • Restricting a search to trusted domains
  • Fact-checking a claim against several sources

Example prompts

  • “Search the news for the latest developments in battery recycling.”
  • “Do an advanced search on climate change solutions and summarize it with sources.”
  • “Search only python.org and docs.python.org for asyncio tutorials.”
  • “Find images and facts about the architecture of the Eiffel Tower.”

Requirements

  • A Tavily API key
  • Python, to run `scripts/tavily_search.py`

Workflow steps

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

  1. Research & Fact-Finding
  2. Current Events
  3. Domain-Specific Research
  4. Visual Research
  5. Content Extraction
  6. Choose the Right Search Depth
  7. Use Domain Filtering Strategically
  8. Optimize for Cost
  9. Handle Errors Gracefully

What it can do on your machine

Read from SKILL.md and the folder at commit 92484b2. 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

    Ships 1 file in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • pip
    • jq
    • python3

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • tavily.com
    • github.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 Web Search loads about 2.5k tokens when it runs, and up to ~3.8k if it reads all its reference files. Until then it costs about 98 tokens; SKILL.md has 632 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~98
When it runs · the whole SKILL.md, loaded when a task matches
~2.5k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~3.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: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteMentions a .env fileSKILL.md:160
    Add to `~/.clawdbot/.env` or your shell profile.

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); the scripts in this folder are not scanned.

SKILL.md

Without a licence we can't republish the file, so here is its outline and opening line. It has 632 words (~2,486 tokens).

“Tavily is a search engine specifically optimized for Large Language Models and AI applications. Unlike traditional search APIs, Tavily provides AI-ready results with optional answer generation, clean content extraction, and domain filtering capabilities.”

— opening of SKILL.md by allenpeng0705
name
tavily

Read the full SKILL.md on GitHub

Files

SKILL.md and 5 other files (scripts, references) in apps/node/skills/tavily of allenpeng0705/EnvoyMesh.

  • SKILL.md
  • .clawhub/origin.json
  • _meta.json
  • references/api-reference.md
  • scripts/tavily_search.py
  • skill-card.md

Open the folder on GitHubat commit 92484b2

Used in 3 other repositories

We found 4 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 3 other GitHub owners. This page covers the copy in allenpeng0705/EnvoyMesh, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Tavily Web Search 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 Web Search compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Tavily Web Search this skillallenpeng0705/EnvoyMesh3.1k3 repos~2.5kAutomated safety check: NotesNone
Argo Search and Verificationtaxueseek/argo188—~1.2kAutomated safety check: PassMIT
Ray Trend Searchimraywang/rayskills159—~2.1kAutomated safety check: PassCustom licence
Multi Source Searchsandbaseai/sandbase-skills203—~1.6kAutomated safety check: PassApache-2.0
AI RAG PipelineNeverSight/learn-skills.dev2171 repos~2kAutomated safety check: PassNone
Perplexity SearchescapeWu/perplexity-ai171—~1.8kAutomated safety check: PassMIT

Similar skills

  • Unified web search, page fetching and evidence checking across hundreds of sources, with result verification, a research-dossier mode and vertical search engines.

    188 GitHub stars~1.2k tokensUpdated 4 days ago
    Research & ScienceAuto-check passed
  • Ray Trend Search

    imraywang/rayskills

    Researches what people are saying about a topic over a recent window across X, Reddit, YouTube and the public web, reporting each source's status with links.

    159 GitHub stars~2.1k tokensUpdated 18 days ago
    Research & ScienceAuto-check passed
  • Multi Source Search

    sandbaseai/sandbase-skills

    Portable multi-source research with cross-source validation and an offline evidence ledger.

    203 GitHub stars~1.6k tokensUpdated 15 days ago
    Research & ScienceAuto-check passed
  • AI RAG Pipeline

    NeverSight/learn-skills.dev

    Build RAG (Retrieval Augmented Generation) pipelines with web search and LLMs.

    217 GitHub starsUsed in 1 repo~2k tokens
    AI & LLM EngineeringAuto-check passed
  • Perplexity Search

    escapeWu/perplexity-ai

    Searches the live web with citations through perplexity-mcp v2 tools or a bundled Python REST client, with focused ask, deep research and detached tasks.

    171 GitHub stars~1.8k tokensUpdated 13 days ago
    Productivity & AutomationAuto-check passed
  • Tavily Deep Research

    sandbaseai/sandbase-skills

    Advanced web search, content extraction, and site mapping through Tavily via SandBase.

    203 GitHub stars~699 tokensUpdated 15 days ago
    Productivity & AutomationAuto-check passed

Works with

Questions about Tavily Web Search

What does Tavily Web Search do?

Searches the web through the Tavily API with LLM-friendly output: clean structured results, optional AI-written answers, domain filters, news mode, images and raw content. py` takes a query and returns structured results, with an AI-generated answer summary if requested. Two depths are available: `basic`, a fast mode of roughly one to two seconds suited to quick facts and definitions, and `advanced`, which takes five to ten seconds and suits research, complex topics and cases where several perspectives help.

When should I use Tavily Web Search?

Tavily Web Search fits situations like: looking up current events with a news-focused search; researching a topic with answer summaries and source links; restricting a search to trusted domains; fact-checking a claim against several sources.

How do I install Tavily Web Search in Claude Code?

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

How do I install Tavily Web Search in Codex?

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

Can I use Tavily Web Search 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 allenpeng0705/EnvoyMesh --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 Web Search need to run?

Going by SKILL.md and its folder, Tavily Web Search needs Python for the scripts in its folder, the command-line tools its instructions call (pip, jq and python3) and credentials named TAVILY_API_KEY. Our summary lists: A Tavily API key; Python, to run `scripts/tavily_search.py`.

Does Tavily Web Search access the network?

SKILL.md names 3 domains. As links in the text: tavily.com, github.com and docs.tavily.com. This is read from the text; nothing was executed.

Is Tavily Web Search safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Tavily Web Search use?

No licence was found for Tavily Web Search or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Tavily Web Search use?

About 2.5k tokens (SKILL.md is roughly 9.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1.3k tokens, read only when the agent opens those files.

What are the alternatives to Tavily Web Search?

Skills that share tags, products or a category with Tavily Web Search: Argo Search and Verification (taxueseek/argo, 188 stars), Ray Trend Search (imraywang/rayskills, 159 stars), Multi Source Search (sandbaseai/sandbase-skills, 203 stars) and AI RAG Pipeline (NeverSight/learn-skills.dev, 217 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Tavily Web Search?

allenpeng0705 (a GitHub user) maintains it in allenpeng0705/EnvoyMesh, which has 3,100 GitHub stars. The repository was last updated on October 10, 2026.

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