tavily

# Tavily Host skill. Not the skills.sh `tvly` CLI pack. REST only. Session agent: `tavily` (`cc tavily`). Copy-lead writes under `.agents/copy/research/inbox/`. ```bash set -a; source ~/secrets/tavily.env; set +a test -n "$TAVILY_API_KEY" || { echo "MISSING ~/secrets/tavily.env"; exit 1; } ``` No file / empty key → stop. Do not print the key. Do not `npx skills add`. Query = search string, **< 400 chars**, not an essay. Split fat questions into 2–4 calls. One note per query. Never append to a single `web.md`. ```bash if [ -d .agents/copy ]; then INBOX=.agents/copy/research/inbox else INBOX=.agents/research/inbox fi STAMP=$(date +%F)-<slug> mkdir -p "$INBOX" ``` Copy the research-note template to `$INBOX/$STAMP.md`. Dump JSON beside it as `$STAMP.json`. Add a row to `.agents/copy/INDEX.md` when that board exists. Do not dump raw HTML into chat. ## search (default) Facts, examples, language snippets, a handful of URLs. Seconds. ```bash curl -sS -X POST https://api.tavily.com/search \ -H "Authorization: Bearer $TAVILY_API_KEY" \ -H "Content-Type: application/json" \ -d '{"query":"<QUERY>","max_results":5,"search_depth":"basic","include_answer":true}' \ > "$INBOX/$STAMP.json" ``` Useful fields (omit if unused): | Field | Values | |---|---| | `search_depth` | `basic` (default), `advanced` | | `max_results` | 1–20 | | `topic` | `general`, `news`, `finance` | | `time_range` | `day`, `week`, `month`, `year` | | `include_domains` / `exclude_domains` | arrays o...