Skip to main content
skill CX Codex

tavily-list — Claude Code skill for Tavily lists

The tavily-list Claude Code skill builds a deduplicated table of search matches for a set. Before searching, it asks for the inclusion rule, columns, and row cap.

MIT 2,500 installs ★ 497 updated 2026-10-23

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add tavily-ai/skills --skill tavily-list -a claude-code
Open on GitHub

What tavily-list does

The skill searches with Tavily and puts verified matches into a table, merging duplicate entries by identity. The results show what the search found, not every match that exists. It searches from several angles and looks up a website separately when a row has none.

Before searching, the inclusion rule, columns, and cap must be settled. The table appears in the reply and is saved to lists/{title}.md. Search stops at the cap or after two consecutive angles add no rows. Tavily and the tavily-search skill are required; if that skill is missing, the instructions give npx skills add tavily-ai/skills --skill tavily-search to install it. Use tavily-entity for a single CRM record or an existing CSV, and tavily-research for an in-depth report.

What it helps with

  • build a list of matches from a defined set
  • merge duplicate entries by identity
  • save search results as a Markdown table
  • limit results to a specified number of rows

Example prompts for the agent

  • Find companies in this category and ask me to set the criteria, columns, and cap before searching.
  • Search from several angles, merge duplicate entries, and save the table to lists/{title}.md.
  • Continue the search and append only entries that are not already in the table.

How to install tavily-list

1Skills CLI (Vercel)

npx skills add tavily-ai/skills --skill tavily-list -a claude-code

2Manually: put the files in place

~/.claude/skills/tavily-list/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/tavily-list/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about tavily-list

How do I install tavily-list in Claude Code?

Run npx skills add tavily-ai/skills --skill tavily-list -a claude-code. The skill file is at ~/.claude/skills/tavily-list/SKILL.md.

What does tavily-list do?

It searches with Tavily, merges duplicate matches, and returns a table of the results. The table does not claim to include every existing match.

What does tavily-list need to work?

It requires Tavily and the tavily-search skill. If tavily-search is not installed, add it with npx skills add tavily-ai/skills --skill tavily-search.

Source text

SKILL.md · MIT
---
name: tavily-list
description: |
  Build a deduplicated table of matches for a set, using Tavily. The table is what search returned, not every match that exists. Use when the user wants a list, all of something, or a table with duplicates removed. Confirm the columns and a cap before searching. For one CRM record, or a CSV of rows they already have, use tavily-entity. For a deep comprehensive report use tavily-research.
allowed-tools: Bash(tvly *)
---

# Tavily list

Return the matches you can verify for a set, one row each, with duplicates
merged. The table is the result. It is not every match that exists. Do not
collapse rows into a summary, and do not call the table complete.

Use `tavily-search` to search and read pages. If it isn't installed, run `npx skills add tavily-ai/skills --skill tavily-search` and read its SKILL.md before continuing. When you open many list pages, save the responses and filter them the way that skill describes, so the raw pages stay out of context.

## When this is the wrong skill

- The user wants one record filled in, or fields added to a CSV of rows they already have. Use `tavily-entity`. If it isn't installed, run `npx skills add tavily-ai/skills --skill tavily-entity` and read its SKILL.md before continuing.
- The user wants a deep comprehensive report. Use `tavily-research`. If it isn't installed, run `npx skills add tavily-ai/skills --skill tavily-research` and read its SKILL.md before continuing.

## Steps

1. Before any search, fix the inclusion rule in one sentence, the columns, and
   a cap. Columns always include name, website or profile, a one-line
   description, and the source URL, plus any the user named. If they did not
   name the extra columns or a cap, ask once and wait. If the set is unbounded
   ("every restaurant"), that question includes the boundary, such as a city
   or a category. A row gets in only when it matches the inclusion rule.
2. Search the set from several angles: the category, "list of" roundups,
   directories, and the names that appear on pages you have already opened. One
   query does not cover the set. Pull every name off a page that is itself a
   list.
3. Give each row an identity. For an organization, that is the website host
   with `www` removed. For a person, it is the profile URL, or the name plus
   the organization when there is no profile. For a product on a shared host,
   it is the canonical URL.
4. Merge rows that share an identity. Keep the fuller row and record the names
   you folded in. When a match has no website yet, search for it once before
   you finish. If it still has none, keep the row and leave the website blank.
5. Stop at the cap, or when two new angles in a row add no rows. Say which.
   Either stop means this pass is finished. Neither means the set is complete.
6. When the user wants more, search again and exclude every name and website
   already in the table. Append only new rows, then merge by identity again.
   Raise the cap by the number they asked for.

Use the same columns on every row. Leave a cell blank when no page states it.

Use `tavily-entity` for a row only when the user asked for CRM fields on each match. If it isn't installed, run `npx skills add tavily-ai/skills --skill tavily-entity` and read its SKILL.md before continuing. Otherwise a list row stays a list row.

## Output

Show the table in the reply, and save the same markdown to `lists/{title}.md`
in the working directory. The title is sentence case, 3 to 6 words, letters,
numbers, and single spaces.

```markdown
# {Title}

Inclusion: {one sentence}
As of: {YYYY-MM-DD}
Cap: {N}
Stop: {two angles added nothing | hit the cap}
Rows: {count after dedup}
Coverage: not exhaustive. This is what the angles below returned.

| Name | Website | Description | {asked columns} | Source |
|---|---|---|---|---|

## Merged
- {kept name} ← {other names} ({shared website})

## Coverage
Angles: {the queries and the list pages you opened}
Excluded this pass: {names and websites already kept, or none}
Likely gaps: {the part of the set this pass could not see}
```

© tavily-ai · MIT · tavily-ai/skills

Similar skills

All skills for Agent setup: memory, context, orchestration →

From the same set13

The whole set →
tavily-best-practices The tavily-best-practices skill gives an agent guidance for Tavily web search, content extraction, site crawling, and research. Use it when adding current web data to an agent workflow or RAG system. CX Codex +1 21,100installs tavily-extract tavily-extract extracts clean text or Markdown from specified pages with Tavily CLI. Use it for JavaScript-rendered content or query-focused page chunks. CX Codex +1 18,600installs tavily-crawl tavily-crawl is a Claude Code skill that crawls websites and extracts documentation as Markdown files or focused text chunks for an agent. CX Codex +1 17,900installs tavily-map tavily-map — a skill that has the agent walk a site and hand back the list of addresses, leaving page text alone. Useful when you know the domain but not the page. CX Codex +1 17,600installs tavily-dynamic-search tavily-dynamic-search is a Claude Code skill that saves raw Tavily search results to disk and filters excerpts before they enter the model context, especially for full-page extraction or multiple queries. CX Codex +1 13,900installs tavily-entity tavily-entity — a skill for Claude Code and Codex that enriches company, person, or organization profiles with Tavily web data. Populates CRM records and CSV spreadsheets while resolving name collisions. CX Codex +1 2,500installs tavily-monitor The tavily-monitor Claude Code skill sets up recurring searches or page checks and stores a baseline. The agent uses it to track new search results or changes to known pages over time. CX Codex +1 2,400installs tavily A set of skills for web search, content extraction, site crawling and deep research, powered by the Tavily CLI. ★ 497repo stars

Project sponsors

Companies that keep this analytics open