How do I install the Search skill?

Run npx skillmds@latest add lord1egypt/search in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Search safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: makes network calls. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Search?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Search free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Search?

Lord1Egypt (@lord1egypt) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Search by lord1egypt — Agent Skill

Name: Search
Rating: 4.666666666666667 (3 reviews)
Author: Lord1Egypt

File contents

Search Skill

Search the web and get relevant results optimized for LLM consumption.

Requirements

Set your API key as an environment variable:

export TAVILY_API_KEY=tvly-...

Get an API key at tavily.com.

Quick Start

The script accepts a single --json argument — the raw Tavily API request body. The JSON maps 1:1 to the Tavily Search API.

./scripts/search.sh --json '{"query": "python async patterns"}'

Examples:

# Quick lookup
./scripts/search.sh --json '{"query": "OpenAI latest funding round"}'

# More results
./scripts/search.sh --json '{"query": "Stripe documentation", "max_results": 10}'

# Recent news only
./scripts/search.sh --json '{"query": "Landscape of electric vehicles 2026", "time_range": "week", "max_results": 10}'

# Scoped to specific sources
./scripts/search.sh --json '{"query": "NVIDIA stock analysis", "search_depth": "advanced"}'

Equivalent curl

The script is a thin wrapper around this call:

curl --request POST \
  --url https://api.tavily.com/search \
  --header "Authorization: Bearer $TAVILY_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "query": "latest developments in quantum computing",
    "max_results": 5
  }'

API Reference

Endpoint

POST https://api.tavily.com/search

Headers

Header	Value
`Authorization`	`Bearer <TAVILY_API_KEY>`
`Content-Type`	`application/json`

Request Body

Field	Type	Default	Description
`query`	string	Required	Search query (keep under 400 chars)
`max_results`	integer	10	Maximum results (0-20)
`search_depth`	string	`"basic"`	`basic`, `advanced`
`time_range`	string	null	`day`, `week`, `month`, `year`
`start_date`	string	null	Return results after this date (`YYYY-MM-DD`)
`end_date`	string	null	Return results before this date (`YYYY-MM-DD`)
`include_domains`	array	[]	Domains to include
`exclude_domains`	array	[]	Domains to exclude
`country`	string	null	Boost results from a specific country (general topic only)
`include_raw_content`	boolean	false	Include full page content
`include_images`	boolean	false	Include image results
`include_image_descriptions`	boolean	false	Include descriptions for images
`include_favicon`	boolean	false	Include favicon URL for each result

Response Format

{
  "query": "latest developments in quantum computing",
  "results": [
    {
      "title": "Page Title",
      "url": "https://example.com/page",
      "content": "Extracted text snippet...",
      "score": 0.85
    }
  ],
  "response_time": 1.2
}

Search Depth

Depth	Latency	Relevance	Content Type
`basic`	Medium	High	NLP summary
`advanced`	Higher	Highest	Chunks

When to use each:

basic: General-purpose, balanced
advanced: Precision matters (default recommendation)

Data Handling

Never include in the JSON body:

Secrets, API keys, or credentials
Personal or sensitive user data

Tips

Keep queries under 400 characters - Think search query, not prompt
Break complex queries into sub-queries - Better results than one massive query
Use include_domains to focus on trusted sources
Use time_range for recent information

---name: searchdescription: Search the web using Tavily's Search API. Returns relevant, accurate results with content snippets, scores, and metadata. Use when the user asks to search the web, look up sources, find links, or research a topic.---# Search SkillSearch the web and get relevant results optimized for LLM consumption.## RequirementsSet your API key as an environment variable:```bashexport TAVILY_API_KEY=tvly-...```Get an API key at [tavily.com](https://tavily.com).## Quick StartThe script accepts a single `--json` argument — the raw Tavily API request body. The JSON maps 1:1 to the [Tavily Search API](https://docs.tavily.com/documentation/api-reference/endpoint/search).```bash./scripts/search.sh --json '{"query": "python async patterns"}'```**Examples:**```bash# Quick lookup./scripts/search.sh --json '{"query": "OpenAI latest funding round"}'# More results./scripts/search.sh --json '{"query": "Stripe documentation", "max_results": 10}'# Recent news only./scripts/search.sh --json '{"query": "Landscape of electric vehicles 2026", "time_range": "week", "max_results": 10}'# Scoped to specific sources./scripts/search.sh --json '{"query": "NVIDIA stock analysis", "search_depth": "advanced"}'```### Equivalent curlThe script is a thin wrapper around this call:```bashcurl --request POST \ --url https://api.tavily.com/search \ --header "Authorization: Bearer $TAVILY_API_KEY" \ --header 'Content-Type: application/json' \ --data '{ "query": "latest developments in quantum computing", "max_results": 5 }'```## API Reference### Endpoint```POST https://api.tavily.com/search```### Headers| Header | Value ||--------|-------|| `Authorization` | `Bearer <TAVILY_API_KEY>` || `Content-Type` | `application/json` |### Request Body| Field | Type | Default | Description ||-------|------|---------|-------------|| `query` | string | Required | Search query (keep under 400 chars) || `max_results` | integer | 10 | Maximum results (0-20) || `search_depth` | string | `"basic"` | `basic`, `advanced` || `time_range` | string | null | `day`, `week`, `month`, `year` || `start_date` | string | null | Return results after this date (`YYYY-MM-DD`) || `end_date` | string | null | Return results before this date (`YYYY-MM-DD`) || `include_domains` | array | [] | Domains to include || `exclude_domains` | array | [] | Domains to exclude || `country` | string | null | Boost results from a specific country (general topic only) || `include_raw_content` | boolean | false | Include full page content || `include_images` | boolean | false | Include image results || `include_image_descriptions` | boolean | false | Include descriptions for images || `include_favicon` | boolean | false | Include favicon URL for each result |### Response Format```json{ "query": "latest developments in quantum computing", "results": [ { "title": "Page Title", "url": "https://example.com/page", "content": "Extracted text snippet...", "score": 0.85 } ], "response_time": 1.2}```## Search Depth| Depth | Latency | Relevance | Content Type ||-------|---------|-----------|--------------|| `basic` | Medium | High | NLP summary || `advanced` | Higher | Highest | Chunks |**When to use each:**- `basic`: General-purpose, balanced- `advanced`: Precision matters (default recommendation)## Data Handling**Never include in the JSON body:**- Secrets, API keys, or credentials- Personal or sensitive user data## Tips- **Keep queries under 400 characters** - Think search query, not prompt- **Break complex queries into sub-queries** - Better results than one massive query- **Use `include_domains`** to focus on trusted sources- **Use `time_range`** for recent information

Frequently asked questions

Search