Tavily Summary

AI-optimized web search with structured summarization, combining Tavily Search API + proven summarization methodology from summarize.

Security Scan

The skill is internally consistent: it calls Tavily's APIs using a single Tavily API key and Node, which matches its stated web-search-and-summarize purpose.

Purpose & Capability

Name/description, required binaries (node), required env (TAVILY_API_KEY), and the included scripts all target Tavily's search/extract API endpoints (api.tavily.com). These requirements are proportionate to a Tavily-backed search-and-summarize tool.

Instruction Scope

SKILL.md describes running the included Node scripts and enforces summarization/formatting rules. The runtime instructions only reference the declared binary and env var; they do not instruct reading unrelated files, other credentials, or sending data to unexpected endpoints.

Install Mechanism

No install spec (instruction-only). Included code files are simple Node scripts that make fetch POSTs to the Tavily API; nothing is downloaded from untrusted URLs and no archives are extracted.

Credentials

The skill requests only TAVILY_API_KEY (primary credential) which is necessary for the described API calls. No unrelated secrets or config paths are requested.

Persistence & Privilege

always is false and the skill does not request persistent or elevated platform privileges. It does not modify other skills or system-wide agent settings.

Assessment

This skill appears to do what it says: it uses your TAVILY_API_KEY and Node to call Tavily's search/extract APIs and prints/returns results for summarization. Before installing, confirm you trust tavily.com and are comfortable that the API key will be sent to api.tavily.com. Notes: (1) the extract script may return full raw page content (possibly including sensitive text) — avoid using a production/privileged key if you are unsure; (2) limit the key's scope or use a separate account if possible and monitor usage on Tavily for unexpected calls; (3) the skill enforces strict summarization rules in SKILL.md but those are formatting instructions, not additional permissions. If you plan to allow autonomous agents to invoke skills, remember autonomous invocation is allowed by default — consider restricting agent autonomy if you want manual control over when the skill can call external services.

AI-optimized web search with structured summarization methodology, combining:

• Tavily Search API for clean, relevant search results (AI-native)
• Proven summarization rules extracted from the summarize project
• Output follows consistent formatting rules for readability

Features

• Search the web with AI optimization (better than plain search engines for AI agents)
• Automatically summarizes results following structured formatting rules:
  • Strict length control, no padding
  • Automatic heading hierarchy for long content
  • Proper citation of key excerpts
  • Ad/sponsor content automatically stripped
  • Consistent Markdown formatting

Usage

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 30

Options

• -n <count>: Number of results (default: 5, max: 20)
• --deep: Use advanced search for deeper research (slower, more comprehensive)
• --topic <topic>: Search topic - general (default) or news
• --days <n>: For news topic, limit to last n days

Extract content from URL

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

Output Summary Rules

Core Principles

• Positioning: Extract key points for users, let them quickly grasp core info and decide whether to read in depth
• Authenticity: 100% based on search results, never fabricate information
• Conciseness: Strictly control length, prefer shorter, never pad for no reason
• Formatting: Use Markdown formatting, long content must split into sections with headings

Formatting Rules

• Content longer than 500 characters equivalent → split with ### prefixed Markdown headings, at least 3 headings
• Short paragraphs, use bullet points only when improves readability, don't force rigid templates
• Include 1-2 short exact excerpts (max 25 words each) as italicized, ignore ads/sponsors/promotions completely, treat them as if they don't exist, don't mention ignoring them

Output Structure (for news search example)

1. One sentence opening summary of the core conclusion
2. Break into points/events, each with core idea + key data
3. (Optional) 1-2 italicized original excerpts
4. One sentence closing summary

Absolute Prohibitions

• ❌ Never include ads/sponsors/promotions/CTAs, delete directly
• ❌ Use straight quotes only, no curly quotes
• ❌ Don't add emojis, disclaimers, unfounded speculation
• ❌ Never exceed requested length, finish early if content is short, don't pad
• ❌ Don't fabricate excerpts, omit if no suitable excerpt exists

Requirements

• TAVILY_API_KEY from https://tavily.com (free plan available: 1,000 searches/month)
• Node.js 18+

Credits

• Search API provided by Tavily
• Summarization methodology refined from summarize