Mathews-TomMathews-Tom/armory/skills/tavily/SKILL.md

tavily

Skill340 starsChanged 8 months agoMITView on GitHub

AI-optimized web search via Tavily API when no URL is provided. Returns clean AI-ready snippets for current info and news. Triggers on: "search the web", "look up online", "find recent information", "web search". NOT for known URLs, use web-fetch.

Reads credentials

10 other projects use a version of this, 4 of them edited.

Adopted by

Most recently taken up by

mahsumaktas/agent-evolution-kitedited, first seen Nov 8, 2026
timsvoice/skillstheir own version, first seen Aug 26, 2026
KCNyu/clawocktheir own version, first seen Aug 21, 2026
Spoon94/skill-vaulttheir own version, first seen Aug 5, 2026
yugasun/skillstheir own version, first seen Jun 24, 2026
koinod/skillsedited, first seen May 22, 2026

Used with

Projects with it also use deep-research and frontend-design.

Other files people use alongside this one.

NVIDIASkill
deep-research
Queue deep, multi-step research and analysis tasks to the DeepAgents worker. Supports execution depth presets, request-specific rubrics, SubAgent delegation, and RubricMiddleware cross-validation.
Also in 3 projects that use this
BlockSkill
frontend-design
Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications. Generates creative, polished code that avoids generic AI aesthetics.
Also in 3 projects that use this

Other versions10 projects use a version of this.
Word for word · 0
None found.
Edited · 4
mahsumaktas/agent-evolution-kit★ 226% same
Lazily01/openclaw-skills★ 126% same
koinod/skills★ 026% same
wangfeiwest2025/openclaw-integration-skills★ 026% same
Wrote their own version · 6
KCNyu/clawock★ 23same name
Spoon94/skill-vault★ 5same name
yugasun/skills★ 3same name
huangqianqian120/skillslibrary★ 1same name
timsvoice/skills★ 1same name
bongartzdiaz/agent-skills★ 0same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository94 other files it gives its agents.
- AGENTS.mdAGENTS.md
- adr-writerSkill
- agent-builderSkill
- animateSkill
- api-docs-generatorSkill
- appraiseSkill
- architecture-diagramSkill
- architecture-reviewerSkill
- arxiv-figuresSkill
- arxiv-packageSkill
- arxiv-preflightSkill
- benchmark-runnerSkill
- changelog-composerSkill
- chart-claritySkill
- citation-auditSkill
- codebase-advisorSkill
- code-refinerSkill
- competitive-analyzerSkill
- concept-to-imageSkill
- debug-investigatorSkill
- decision-mapSkill
- dependency-auditSkill
- devils-advocateSkill
- domain-modelingSkill
- engineering-retroSkill
- env-validatorSkill
- estimate-calibratorSkill
- feasibility-assessorSkill
- figure-rhetoricSkill
- figure-table-qualitySkill
- filesystemSkill
- githubSkill
- gpu-optimizerSkill
- handoffSkill
- html-presentationSkill
- html-videoSkill
- humanizeSkill
- idea-validatorSkill
- immuneSkill
- intakeSkill
- kg-builderSkill
- launch-videoSkill
- learning-workspaceSkill
- lightpanda-browserSkill
- linkedin-post-styleSkill
- literature-reviewSkill
- manuscript-provenanceSkill
- manuscript-reviewSkill
- manuscript-typographySkill
- market-analyzerSkill
- marp-slidesSkill
- mcp-to-skillSkill
- md-to-pdfSkill
- migration-risk-analyzerSkill
- milestone-runnerSkill
- module-deepeningSkill
- notebooklmSkill
- package-evaluatorSkill
- package-optimizerSkill
- paper-to-skillSkill
- The first 60 shown.

The file

We split this skill into the rules it gives an agent

2 rules. 0 are common, 2 are distinctive, and 0 are very specific to this project.

0
Common
Most of the 10 edited versions we read keep these.
2
Distinctive
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.

Common
Distinctive
Very specific

Distinctive:
Use when you already have a URL and need the full page content — Tavily strips navigation, ads, and boilerplate, returning structured …
line 59
Distinctive:
Search results return a JSON array.
line 64

“Common” is measured: kept by at least 6 in 10 of the 10 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.

Files

SKILL.md

Tavily Search

Web search and URL content extraction powered by Tavily API. Returns clean, structured results optimized for AI consumption — no HTML noise, no cookie banners, no pagination.

When to Use Tavily vs Other Tools

Situation	Tool	Reason
Need current information on a topic	`search.mjs`	Tavily aggregates and ranks live results
Need news from the last N days	`search.mjs --topic news --days N`	News mode filters recency
Have a specific URL, need full text	`extract.mjs`	Extracts clean article content from URL
Need documentation for a library	`search.mjs --deep`	Deep mode covers docs sites thoroughly
Need a static resource already known	direct fetch or read	Skip Tavily if no live lookup needed
Need multiple competing perspectives	`search.mjs -n 10`	Increase result count for breadth

Scripts

Both scripts exist at scripts/ and require TAVILY_API_KEY in the environment.

scripts/search.mjs — query-based web search
scripts/extract.mjs — full content extraction from a URL

Search

node {baseDir}/scripts/search.mjs "query"
node {baseDir}/scripts/search.mjs "query" -n 10
node {baseDir}/scripts/search.mjs "query" --deep
node {baseDir}/scripts/search.mjs "query" --topic news
node {baseDir}/scripts/search.mjs "query" --topic news --days 3

Search Options

Option	Default	Description
`-n <count>`	5	Number of results to return (max: 20). Increase for broader coverage.
`--deep`	off	Advanced search mode — slower but more comprehensive. Use for complex research questions, technical deep-dives, or when standard results are insufficient.
`--topic <topic>`	`general`	`general` for standard search; `news` for current events filtered by recency.
`--days <n>`	—	Only valid with `--topic news`. Limits results to articles published in the last n days.

Extract Content from URL

node {baseDir}/scripts/extract.mjs "https://example.com/article"

Use when you already have a URL and need the full page content — Tavily strips navigation, ads, and boilerplate, returning structured article text.

Output Format

Search results return a JSON array. Each result contains:

[
  {
    "title": "Article or page title",
    "url": "https://source.com/path",
    "content": "Clean text snippet (AI-optimized excerpt)",
    "score": 0.92
  }
]

score is Tavily's relevance ranking (0–1). Higher is more relevant. When parsing results, use content for summarization and url for attribution. Do not treat content as the full article — use extract.mjs on the URL if complete text is needed.

Extract output returns a single object:

{
  "url": "https://source.com/path",
  "raw_content": "Full extracted page text..."
}

Error Handling

Error	Cause	Resolution
`TAVILY_API_KEY not set`	Environment variable missing	Set `TAVILY_API_KEY` before running. Get a key at https://tavily.com
`401 Unauthorized`	Invalid API key	Verify the key value; regenerate at Tavily dashboard if needed
`429 Too Many Requests`	Rate limit hit	Reduce request frequency; free tier allows 1000 API credits/month
Empty results array `[]`	No matches found	Broaden or rephrase the query; try `--deep` for niche topics
`ETIMEDOUT` / timeout	Network or API latency	Retry once; `--deep` searches take longer (up to 30s)
Extract returns empty content	Page blocks scrapers	Use a different source or fall back to a manual fetch approach

Limitations

Rate limits: Free tier is 1000 API credits/month. Each search costs 1 credit; --deep costs more.
Content freshness: Results reflect Tavily's index; very recent content (last few hours) may not appear in general mode. Use --topic news for recency-sensitive queries.
Result quality: Tavily optimizes for AI-readable content but cannot guarantee factual accuracy. Verify critical claims from primary sources.
Paywalled content: Articles behind paywalls return only the publicly accessible excerpt.
Non-text content: PDFs, images, and media pages extract poorly or not at all.
Language: Best results for English queries. Other languages are supported but result quality varies.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

It worked
Partly
It didn't

What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

Check your setup, free