skills.rest
LGJ-Jonathan
LGJ-JonathanOFFICIAL
Explore all skills by this author →
GitHub

ai-ark-list-builder

Builds validated lead-list queries for the AI ARK API from audience targeting documents.

Updated Mar 26, 2026
Search Tags:#lead generation#audience targeting#people search#b2b sales#prospect list#ai ark api#email export
One-click install
npx skills add https://github.com/LGJ-Jonathan/Jonathan_Global_Claude_Skills --skill ai-ark-list-builder-lgj-jonathan
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ai-ark-list-builder
Source: https://github.com/LGJ-Jonathan/Jonathan_Global_Claude_Skills/tree/main/Skills%20Sofi/ai-ark-list-builder
Command: npx skills add https://github.com/LGJ-Jonathan/Jonathan_Global_Claude_Skills --skill ai-ark-list-builder-lgj-jonathan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Converting an audience targeting document into working lead-search API queries is error-prone: invalid industry names, broken filters, and over-narrow filter stacks silently return zero or useless results. This Skill parses targeting documents, maps criteria to verified AI ARK API filters, and enforces a validation-first workflow so no API credits are spent on unreviewed queries. ## Core Features & Use Cases - Document-to-Query Conversion: Parses audience targeting documents into per-segment AI ARK API query JSON, mapping industries, seniority, location, company type, employee size, revenue, and founded year to valid filter values. - Broken-Filter Avoidance: Enforces known-good filter usage (seniority instead of title, DESCRIPTION/INDUSTRY keyword sources) and warns about filter stacking that returns zero results. - Approval-Gated Execution: Presents a filter summary table and full JSON query for user approval before any API call, then supports execution, result review, iterative refinement, and bulk export with verified emails. - Use Case: A sales team provides a targeting doc for gym and med spa owners; the Skill builds two separate validated queries, checks API credits, gets user approval, runs the searches, and exports up to 10,000 leads with emails. ## Quick Start Ask the AI to build a lead list from your audience targeting document using the AI ARK API and review the generated queries before they run.

Frequently Asked Questions about ai-ark-list-builder

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

FAQPage Schema
How do I build a lead list from an audience targeting document?▼

Provide the targeting document and the Skill parses each segment, maps criteria to valid AI ARK API filters, and presents the query JSON for your approval. Only after you confirm does it execute the search and show results.

What AI ARK API filters work for finding decision makers?▼

Use the contact.seniority filter with values like Owner, Founder, VP, Director, Head, or Partner. The contact.title include filter is broken and returns 525M results regardless of input, and the CXO and President seniority values return zero results.

Why does my AI ARK people search return zero results?▼

Zero results usually come from stacking four or more filter categories, using the KEYWORD keyword source, or using CXO/President seniority values. Remove the most restrictive filter, typically keyword or employeeSize, and re-run with a broader query.

Can I export leads with verified email addresses?▼

Yes, the POST /v1/people/export endpoint exports up to 10,000 results with emails and returns a trackId. Poll the statistics endpoint until completion, then retrieve paginated results from the inquiries endpoint.

How are industry names validated before running a search?▼

The Skill reads industries.json and matches the document's industry descriptions to the 148 valid AI ARK industry values, such as mapping gyms to "wellness and fitness services" and med spas to "medical practices".

Related Skills

Explore More Marketing & Sales Skills→
indranilbanerjeeindranilbanerjee
726

segment-audience

Build audience segments from CRM, email, and ad data with platform-specific payloads.

Community
Advanced
eylulsenakumraleylulsenakumral

cold-email-sequence-generator

Generate personalized multi-touch cold email sequences with A/B subject lines and timing schedules.

Community
Intermediate
gooseworks-aigooseworks-ai
1.1k

inbound-lead-enrichment

Enrich inbound leads with company and person research for CRM readiness.

Official
Advanced
DevMatt6DevMatt6

prospecting

Build and qualify prospect lists for B2B SaaS and local businesses.

Community
Advanced