Skip to main content

GitHub

/tavily-ai/skills

Get API Key

Sign up at tavily.com

​
Why Use These Skills?

These official skills define best practices for working with the Tavily API, going beyond just using the endpoints. They give AI agents low-level control to build custom web tooling directly in your development environment. These skills bring Tavily’s services (search, extract, crawl, research) right where you work. The real-time context these tools provide significantly enhances your agent’s capabilities for development tasks. Most importantly, the tavily-best-practices skill turns your AI agent into a true Tavily expert. Instead of reading API docs, just ask your agent how to integrate Tavily into your project. All API best practices are baked in, dramatically accelerating your build process.

​
What You Can Build

Copy-paste these prompts into your AI agent and start building:
Create a live news dashboard that tracks topics and analyzes sentiment.Try these prompts:
/tavily-best-practices Build a website that refreshes daily with Tesla news and gives a sentiment score on each article

/tavily-best-practices Create a news monitoring dashboard that tracks AI industry news and sends daily Slack summaries
Build tools that automatically enrich leads with company data from the web.Try these prompts:
/tavily-best-practices Build a lead enrichment tool that uses Tavily to find company information from their website

/tavily-best-practices Create a script that takes a list of company URLs and extracts key business information
Build an autonomous agent that monitors competitors and surfaces insights.Try these prompts:
/tavily-best-practices Build a market research tool that crawls competitor documentation and pricing pages

/tavily-best-practices Create an agent that monitors competitor product launches and generates weekly reports
The /tavily-best-practices skill is your fastest path to production. Describe what you want to build and your agent generates working code with best practices baked in.

​
Installation

​
Prerequisites

  • Tavily API key - Sign up for free
  • An AI agent that supports skills (Claude Code, Codex, Cursor, etc.)

​
Step 1: Configure Your API Key

Add your Tavily API key to your agent’s environment. For Claude Code, add it to your settings file: 
# Open your Claude settings file
open -e "$HOME/.claude/settings.json"

# Or with VS Code
code "$HOME/.claude/settings.json"
Add the following configuration: 
{
  "env": {
    "TAVILY_API_KEY": "tvly-YOUR_API_KEY"
  }
}
Replace tvly-YOUR_API_KEY with your actual Tavily API key from app.tavily.com

​
Step 2: Install the Skills

Run this command in your terminal: 
npx skills add tavily-ai/skills

​
Step 3: Restart Your Agent

After installation, restart your AI agent to load the skills.

​
Available Skills

Tavily Best Practices

Build production-ready Tavily integrations with best practices baked in. Reference documentation for implementing web search, content extraction, crawling, and research in agentic workflows, RAG systems, or autonomous agents.Invoke explicitly:
/tavily-best-practices
Example prompts:
  • “Add Tavily search to my internal company chatbot so it can answer questions about our competitors”
  • “Build a lead enrichment tool that uses Tavily to find company information from their website”
  • “Create a news monitoring agent that tracks mentions of our brand using Tavily search”
  • “Implement a RAG pipeline that uses Tavily extract to pull content from industry reports”
Get AI-synthesized research on any topic with citations. Supports structured JSON output for integration into pipelines.Invoke explicitly:
/research
Example prompts:
  • “Research the latest developments in quantum computing”
  • “/research AI agent frameworks and save to report.json”
  • “Research the competitive landscape for AI coding assistants”
Crawl any website and save pages as local markdown files. Ideal for downloading documentation, knowledge bases, or web content for offline access or analysis.Invoke explicitly:
/crawl
Example prompts:
  • “Crawl the Stripe API docs and save them locally”
  • “/crawl https://docs.example.com”
  • “Download the Next.js documentation for offline reference”
Extract content from specific URLs using Tavily’s extraction API. Returns clean markdown/text from web pages.Invoke explicitly:
/extract
Example prompts:
  • “Extract the content from this article URL”
  • “/extract https://example.com/blog/post”
  • “Extract content from these three documentation pages”

​
Usage Examples

​
Automatic Skill Invocation

Your AI agent will automatically use Tavily skills when appropriate. Simply describe what you need: 
Research the latest developments in AI agents and summarize the key trends

Search for the latest news on AI regulations

Crawl the Stripe API docs and save them locally

​
Explicit Skill Invocation

You can also invoke skills directly using slash commands: 
/research AI agent frameworks and save to report.json

/search current React best practices

/crawl https://docs.example.com

/extract https://example.com/blog/post

/tavily-best-practices

​
Claude Code Plugin

If you’re using Claude Code specifically, you can also install the skills as a plugin.

​
Step 1: Configure Your API Key

Add your Tavily API key to your Claude Code settings file: 
code ~/.claude/settings.json
Add the following configuration: 
{
  "env": {
    "TAVILY_API_KEY": "tvly-YOUR_API_KEY"
  }
}

​
Step 2: Install the Skills

Run these commands inside Claude Code: 
/plugin marketplace add tavily-ai/skills

/plugin install tavily@skills

​
Step 3: Restart Claude Code

Clear your session and restart to load the plugin: 
/clear
Then press Ctrl+C to restart.