clay-search-query

Convert natural-language audience descriptions into Clay search queries over people, companies, and jobs.

3|2|Updated Jul 9, 2026
One-click install
npx skills add https://github.com/Growth-Today/claude-skills --skill clay-search-query-growth-today
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: clay-search-query
Source: https://github.com/Growth-Today/claude-skills/tree/main/clay-search-query
Command: npx skills add https://github.com/Growth-Today/claude-skills --skill clay-search-query-growth-today

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Writing valid Clay advanced search queries requires knowing the query grammar, field names, enum values, and operator semantics. This Skill translates plain-language audience descriptions, job postings, briefs, and ICP notes into correct Clay search queries without manual syntax lookup. ## Core Features & Use Cases - Natural-language to query conversion: Turn descriptions of leads, companies, candidates, or job postings into valid select from Clay search queries. - Entity and filter reasoning: Automatically choose the right result entity (people, companies, jobs) and express cross-entity filters like experiences.any(...), people.exists(...), and jobs.exists(...). - Guardrails and transparency: Apply defaults for tenure, job status, and low-coverage fields, and clearly report any criteria the dataset cannot capture. - Use Case: A sales rep pastes an ICP note like "VP Sales leaders at B2B SaaS companies in Germany with 50-500 employees" and receives a ready-to-paste Clay search query for https://clay.com. ## Quick Start Ask the assistant to write a Clay search query for the audience or job postings you want to find, describing your filters in plain language.

Frequently Asked Questions about clay-search-query

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I write a Clay search query from a plain-language description?▼

Describe the leads, companies, or job postings you want in plain language, and the Skill generates a valid Clay advanced search query. It asks a brief follow-up question first unless you tell it not to, then produces a query you can paste into Clay Search at clay.com.

What can Clay Search filter on for people, companies, and jobs?▼

People queries cover profile data, work experience, and education; companies queries cover profile data, classifications, and technographics; jobs queries cover open postings and postings closed within the last 6 months. Each entity has its own documented field list and enum values.

Can Clay search queries filter by email addresses or phone numbers?▼

No. The Clay Search dataset cannot filter by emails, phone numbers, Fortune 500 status, or competitor relationships. Those require adding enrichments after the search runs in Clay, and the Skill will tell you which criteria were not captured.

Why does my Clay query use is_similar_to instead of contains for job titles?▼

The Skill defaults to is_similar_to on job_title because it expands titles into synonyms and variants for better recall. It switches to contains or exact matching only when you ask for literal keyword matching or exact titles.

What are the limitations of Clay search query generation?▼

Queries encode filtering only, not scoring, ranking, or output columns like emails and tech stack. If some criteria fall outside the dataset, the Skill still generates a query for the expressible filters and explains what was not captured.