GTM prospecting, enrichment, outreach, and plays. Discovery: deepline-pre-research. Providers: adyntel,affinity,ai_ark,allegrow,amplemarket,apify,attention,attio,aviato,bettercontact,bigquery,bloomberry,bluesky,bounceban,browserbase,builtwith,clickhouse,cloudflare,contactout,contextdev,crustdata-v3,customer_db,dataforseo,datagma,deepline_ip_to_company,deepline_native,deeplineagent,discolike,dropleads,emailbison,emailguard,enformion,enigma,exa,findymail,firecrawl,fireflies,firmable,forager,fullenrich,generic_http,gong,google_ads_audiences,google_workspace,hackernews,harvestapi,heyreach,hubspot,hunter,icypeas,instantly,intercom,ipqs,kernel,leadmagic,lemlist,limadata,linkedin_ads_audiences,linkedin_scraper,lusha,meta_audiences,nooks,openmart,opensosdata,openwebninja,outreach,parallel,peopledatalabs,podscan,predictleads,prospeo,quickenrich,redshift,rocketreach,salesforce,salesforge,scrapecreators,sentrion,serper,slack,smartlead,snowflake,sumble,theirstack,trestle,twitterapi,upcell,versium,wiza,zerobounce.
53
60%
Does it follow best practices?
Run evals on this skill
Adds up to 20 points to the overall score
View guide
Low
Low-risk findings worth noting
Fix and improve this skill with Tessl
tessl review fix ./skills/deepline-gtm/SKILL.mdnpm install -g deepline
# Fallback for secure sandboxes: mkdir -p "$HOME/.local" && npm config set prefix "$HOME/.local" && export PATH="$HOME/.local/bin:$PATH" && npm install -g deepline --registry https://code.deepline.com/api/v2/npm/
deepline auth register --wait auto
deepline auth wait --timeout 120 # completes Cowork/browser approval; no-op if already connected
deepline auth status
deepline -hRun deepline commands bare — no pipes, redirection, 2>&1, command chaining, or backgrounding around them. The CLI already formats, truncates, and prints what you need; deepline billing usage | head reads as parsing and loses output.
Run deepline when it is available. If the shell reports that command is missing, use <workspace-root>/.deepline/runtime/bin/deepline (or the npm-created .cmd shim on Windows). If neither exists, follow https://code.deepline.com/INSTALL.md to set up Deepline.
Use this skill for prospecting, account research, contact enrichment, verification, lead scoring, personalization, and campaign activation.
provider-playbooks/*.md.Customer is generally trying to go from "I have an ICP" to "Here's a list of prospects with email/linkedin and very personalized content or signals". They may be anywhere in this process, but guide them along.
Ask for requirements, not implementation instructions. Requirements are the business outcome, target population, constraints, time horizon, requested destination, and any stated spend or authority boundary. The provider, tool, query shape, identifier recovery, filter expression, fallback order, and workflow structure are implementation decisions. Infer and execute the latter; do not turn them into a questionnaire. When a requirement is genuinely absent and materially changes the result or external action, ask one concise question with a recommendation. Otherwise state a reasonable assumption in the result and keep moving.
Calibrate monitor filters from real events. When history is supported, use
one broad, price-approved preview unless the user asks for forward-only. Run it
after pricing in test workspaces; in customer workspaces, ask one approval after
showing the price. A dry-run proves configuration, not signal quality. Refine
only from observed matches. This applies to titles, department, seniority,
geography, event category, and every other supported field. Read
recipes/deepline-monitors.md, then keep,
refine, or stop the watcher. Do not substitute a plan, made-up examples, or a
people search.
Start with recoverable identifiers, the live contract, and Deepline price; then preview the signal when supported. Forward-only tuning needs forward observation. Do not ask implementation questions.
Discovery order: companies first, then people. When the task requires finding contacts at companies matching criteria (portfolio, ICP, hiring signal), discover the company set first, then find people at each company. Do not start with broad people-search queries.
Named companies are enough to start. When the user gives company names but not domains, resolve each canonical company domain before asking them for anything. A domain is a recoverable identifier, not clarification debt. Carry the resolved domain and its official-page evidence into the downstream lookup; do not ask the user to paste a domain list merely because a later tool needs one. Read finding-companies-and-contacts.md for the identity gate and ambiguity handling.
Known companies + nuanced roles: qualify the real title roster first. For requests such as "AI leadership at Mount Sinai," "job titles at these companies," or "find the RevOps buyers at these accounts," read and follow recipes/find-qualified-titles.md: company_titles -> qualify exact roster titles -> deepline_native_search_contact with title_lists. Use Exa afterward for public-profile gaps and DropLeads last for supplemental database rows. Broad audience sizing remains a valid DropLeads use case.
SKILL.md): decision model, guardrails, approval gates, links to sub-docs.prompts.json.recipes/*.md): step-by-step playbooks for specific tasks (email lookup, LinkedIn resolution, waterfall patterns, contact finding, actor contracts). Search like code with Grep.provider-playbooks/*.md): provider-specific quirks, cost/quality notes, and fallback behavior.No-loss rule: moved guidance remains fully documented at its canonical level and is linked from here.
If Deepline CLI V2 or SDK mode seems broken while running a GTM task, check deepline switch status. Use deepline switch sdk to move an installer-managed CLI to SDK mode, or deepline switch python to roll back to the Python CLI. Auth is host-scoped and should carry across both families.
STOP. Do not call any provider, run any deepline tools execute, or write any search command until you have opened the correct sub-doc for your task.
These sub-docs are distilled from hundreds of real runs: validated parameter schemas, correct filter syntax, parallel execution patterns, and known pitfalls. Reading a doc for 5 seconds saves 10 failed tool calls, wasted credits, and garbage output. SKILL.md is the routing layer — WHERE, not HOW. Agents that skip the doc and "just try one provider real quick" re-discover the same documented failure modes every time. This has happened repeatedly.
!important READING MULTIPLE DOCS IS A GREAT IDEA AND OFTEN SUPER ESSENTIAL. JUST READ MORE.
Routing rules — match your task to a doc and READ IT:
| When the task involves... | You MUST read this doc first | What it gives you (that SKILL.md doesn't) |
|---|---|---|
| Finding companies, finding people, building lead lists, prospecting, portfolio/VC sourcing, contact finding at known companies, coverage completion at scale | finding-companies-and-contacts.md | Provider filter schemas, parallel execution patterns, provider mix tables, role-based search rules, subagent orchestration, at-scale coverage completion, portfolio/VC shortcuts, contact finding patterns. |
Researching companies or people, understanding what they build, figuring out use cases, personalizing based on mission/product/industry, enriching a CSV, adding data columns, waterfall enrichment, finding emails/phones/LinkedIn, coalescing data, custom signals, run_javascript / deeplineagent columns, Apify actors — any task that adds or transforms row-level data | enriching-and-researching.md | Play routing per scenario (deepline plays run + batch prebuilts + fork/wrap), waterfall orders for email/phone/LinkedIn, run_javascript / deeplineagent routing inside custom plays, multi-pass pipeline patterns, coalescing, custom signal buckets, Apify actor selection, GTM definitions and defaults. |
Writing or running custom Deepline plays — composing multiple tools and/or other plays, mapping over CSV rows, fallback logic, joins/projections, durable datasets, custom run/export behavior, webhook/cron-style orchestration, or a reusable .play.ts scratchpad. Read it whenever no prebuilt play fits a batch job. | recipes/deepline-plays.md | Direct vs compose decision, play search/describe discipline, bootstrap/wrap/fork rules, durable authoring basics, webhook/cron replacement routing, run/export/repair routing, and exact SDK/API reference pointers. |
| Writing cold emails, personalizing outreach, lead scoring, qualification, sequence design, campaign copy, inspecting CSVs in Playground. If the task also requires researching companies/people to inform the writing, read enriching-and-researching.md too — it has the multi-pass pipeline pattern. | writing-outreach.md | Prompt templates from prompts.json. Scoring rubrics. Email length/tone/structure rules. Personalization patterns. Qualification frameworks. Playground inspection commands. |
Deepline Monitors — continuously capturing a provider's webhook events (email replies, new job postings, intent signals) into a Customer DB table, or deploying/listing/managing those upstream provider pipes. Event-driven streaming, NOT an on-demand enrich/sourcing run. Conditional gate: run deepline monitors status --json first. Read the recipe only when the command exits 0 with has_access: true. Exit 1 with has_access: false means rollout access is absent. For exit 3, fix auth/permission; for exit 5, diagnose configuration/server reachability. Do not reinterpret other failures as rollout denial. | recipes/deepline-monitors.md | What Monitors are, when to use them vs plays, the full deepline monitors command set (status, available, check, deploy, list, get, update, delete, reactivate), monitor definition shape, the provider-webhook → Customer DB → triggered-play data flow, and the access gating. |
If you are hand-authoring enrich columns instead of using a native play, jump straight to the "Handmade step shape quick reference" section in enriching-and-researching.md. That section spells out the exact runtime contract for run_javascript, extract_js, result, and persisted matched_result.
The recipes/ directory contains battle-tested playbooks. Before you start executing, scan this list and read any recipe that matches your task.
When a recipe matches: follow it step-by-step as your execution plan. Recipes encode hard-won sequencing and provider choices — trust them over generic guidance or your own intuition. If the user's request doesn't perfectly fit, adapt the recipe using the phase docs above, but keep the recipe's structure and ordering as your baseline.
| Recipe | Use when... |
|---|---|
account-orgchart.md | Building an org chart, account map, buying committee, stakeholder map, or multi-threading plan around a target person or company |
build-tam.md | Building a total addressable market list or large company list from ICP criteria |
clay-to-deepline.md | Converting a Clay table to Deepline (deprecated enrich-era recipe — use its action mappings, author the result as a custom play) |
deepline-monitors.md | ACCESS-GATED. Deepline Monitors continuously capture a provider's webhook events into a Customer DB table and trigger plays. Run deepline monitors status --json first; only exit 1 with has_access: false is a clean rollout denial. Diagnose auth, configuration, and server failures by their actual exit code. |
deepline-plays.md | Creating custom .play.ts scripts that compose multiple tools/plays, durable datasets, fallback logic, joins/projections, webhook/cron-style orchestration, and custom run/export behavior |
find-qualified-titles.md | Primary path for nuanced roles at known companies: "AI leadership at Mount Sinai", "find all job titles at these companies", or "find the marketing-ops/RevOps/Salesforce buyers". Pull each company's real title roster (free company_titles), qualify exact titles, then find contacts with tiered (LinkedIn, email, phone) reveal. |
linkedin-url-lookup.md | Resolving a person's LinkedIn profile URL from their name and company with strict identity validation |
portfolio-prospecting.md | Finding companies backed by a specific investor or accelerator, then finding contacts and building personalized outbound |
small-business-prospecting.md | Finding local small businesses or storefront/service-area companies using Maps-style search. Doctors, services business, restaurants, etc. |
Public/social source discovery, community-language pulls, pre-research source planning, or provider-coverage/cost comparison → use the standalone
deepline-pre-researchskill, not a recipe here. It owns X/Twitter, Reddit, Hacker News, Bluesky, and public-registry fanout plus the source-plan + Deepline-cost synthesis.
If none match, grep for more specific keywords: Grep pattern="<keyword>" path="<directory containing this SKILL.md>/recipes/" glob="*.md" output_mode="files_with_matches"
deepline csv show --csv <path> --summary first to understand its shape (row count, columns, sample values) before deciding how to process it.deepline csv show --csv <path> --rows 0:2 for a two-row sample, or spawn an Explore subagent to answer questions about the data.head -3 in.csv > pilot.csv), run the play on the slice, deepline runs export and inspect, then run the full file. Small-input exception: when an exact-fit prebuilt covers a small input (≤ ~25 rows) whose scope the user already stated, the full file IS the pilot — run it once.deepline runs export <run-id> --out "$FINAL_CSV". Finishing with only a pilot CSV, or an export under a play-derived name, is the single most common way to fail the task while feeling done.For signal-driven discovery (investor, funding, hiring, headcount, industry, geo, tech stack, compliance), start with deepline tools search. Do not guess fields. Its syntax is deepline tools search [query] [--categories <categories>] [--search_terms <terms>] [--json]: provide a query, or at least one of --categories and --search_terms. The query is optional only for structured filtering. Use commas for multiple categories or search terms. There is no --prefix flag; include a provider name in the query when needed.
Search 2-4 synonyms, execute in parallel:
deepline tools search investor
deepline tools search "crustdata investor"
deepline tools search --categories company_search --search_terms "structured filters,icp"
deepline tools search --categories people_search --search_terms "title filters,linkedin"Filter deepline tools search with --categories when tool type matters more than provider breadth: company_search, people_search, company_enrich, people_enrich, email_finder, email_verify, phone_finder, phone_verify, smb, research, automation, outbound_tools, autocomplete, admin. Add --search_terms ranking hints like structured filters, title filters, api native, bulk.
Tags are the signal-oriented filter (GET /api/v2/tools?tags=..., comma = AND): firmographics, funding, hiring, technographics, web, ads, intent, people, contact, competitive, social, research, plus capability tags (email_finder, phone_verify, identity_resolution, ...). billed_on_match means per-result pricing — a charge only on a returned match; never assume a finder has it, filter or read the pricing unit.
Good: deepline tools search --categories company_search --search_terms "investors,funding". Avoid unanchored queries like deepline tools search stuff. Keep evidence, source, date, and confidence with the underlying signal.
For row-by-row processing (per customer, per lead, per LinkedIn URL), run a Deepline play via deepline plays run. deepline enrich is deprecated — do not use or document it; when no play fits, author one.
Discover live, then run. deepline plays search <query> and deepline plays describe <name> — choose from the live catalog and its contract, never from memory. Search results include a runCommand and a cloneEditStarter for every prebuilt.
Prebuilt fits → run it. Batch prebuilts take a CSV directly: deepline plays run prebuilt/name-and-domain-to-email-waterfall-batch --input '{"csv":"leads.csv"}', then deepline runs export <run-id> --out "$FINAL_CSV".
Close but not exact → pull and edit it. Every prebuilt is forkable:
deepline plays get prebuilt/<name> --source --out ./<name>.play.ts
deepline plays check ./<name>.play.ts # mandatory before running
deepline plays run --file ./<name>.play.ts --input '{...}'If plays check fails on a missing local import, that prebuilt is multi-file — wrap it instead of forking: deepline plays bootstrap <family> --from <source> --using play:prebuilt/<name> --limit 5 --out workflow.play.ts.
No play fits → author one from scratch per recipes/deepline-plays.md: compose tools and other plays, map CSVs, add fallback logic and joins.
Results live in the Customer DB. Every batch play persists its dataset as a durable table: deepline db query --sql 'select * from "storage"."<table>" limit 20' --max-rows 20 --json (the run output names the table). Columns are the play's snake_case fields plus per-leg columns like email_result__hunter_email — the per-provider audit trail. Rerunning reuses filled cells instead of re-buying them; exports are projections of this table, so nothing is lost if a CSV goes missing.
The iterate loop — pilot, price, fix, then scale:
deepline runs get <run-id> --full --json reports billing and per-step outcomes; the storage table's per-leg columns show which providers hit, missed, or erred.columns map; weak coverage gets a different route. Do not buy the same failure at full scale.FINAL_CSV, and report to the user: rows delivered, coverage, observed credits, and what you changed after the pilot.GTM time windows, thresholds, and interpretation rules are defined in the Definitions section of enriching-and-researching.md.
Provider-specific playbooks are bundled as separate reference files. Open the relevant playbook when provider-specific behavior, pricing, caveats, or payload conventions matter.
adyntel, affinity, ai_ark, allegrow, amplemarket, apify, attention, attio, aviato, bettercontact, bigquery, bloomberry, bluesky, bounceban, browserbase, builtwith, clickhouse, cloudflare, contactout, contextdev, crustdata, crustdata-v2, crustdata-v3, dataforseo, datagma, deepline_ip_to_company, deepline_native, deeplineagent, discolike, dropleads, emailbison, emailguard, enformion, enigma, exa, findymail, firecrawl, fireflies, forager, fullenrich, generic_http, gong, google_ads_audiences, hackernews, harvestapi, heyreach, hubspot, hunter, icypeas, instantly, intercom, ipqs, kernel, leadmagic, lemlist, limadata, linkedin_ads_audiences, lusha, meta_audiences, nooks, openmart, opensosdata, openwebninja, outreach, parallel, peopledatalabs, podscan, predictleads, prospeo, quickenrich, redshift, salesforce, salesforge, scrapecreators, sentrion, serper, smartlead, snowflake, sumble, theirstack, trestle, twitterapi, upcell, versium, wiza, wizleads, zerobounce
NEVER write files to /tmp/ or any absolute temp directory. Files in system /tmp/ are wiped on reboot — users permanently lose enriched CSVs, research outputs, and hours of paid enrichment work. This is a critical data-loss risk.
Set up a descriptive project-local working directory as your first action:
WORKDIR="deepline/data/<descriptive-task-slug>" && mkdir -p "$WORKDIR" && echo "$WORKDIR"The slug must describe the task (e.g. deepline/data/yc-cmo-outbound, deepline/data/acme-email-waterfall). Do NOT use random names like mktemp generates — the user needs to find these files later. See enriching-and-researching.md for full details.
deepline tools execute is short sighted._metadata) end-to-end. When rebuilding intermediate CSVs with shell tools, carry forward _metadata columns.See enriching-and-researching.md for deepline csv commands, pre-flight/post-run script templates, and inspection details.
FINAL_CSV="${OUTPUT_DIR:-$WORKDIR}/<requested_filename>.csv"FINAL_CSV as soon as the first complete rows exist and overwrite it as later phases improve it. A timeout or crash must leave the best-so-far file at the requested path — intermediates under other names do not count as delivery.play page: https://code.deepline.com/dashboard/plays/...). The final message must contain the exact FINAL_CSV path AND that play page link, so the user can open the live sheet, inspect rows, and rerun. A results message without the play link is incomplete.This section's pilot, CSV preview, and full-run template governs enrichment,
sourcing, and other row-processing runs. Monitor mutations use the workflow in
recipes/deepline-monitors.md instead: show the final provider scope, output
streams/tables, selected Deepline pricing and expected exposure, reuse
candidates, known dependent plays plus the unknown-consumer warning, and the
built-in dry-run when that command supports one. When the user stated the scope
and asked to deploy or reactivate it, that request authorizes the validated
mutation. Ask only when a material requirement is missing or the check reveals
an invalid or unaffordable configuration.
User-stated scope = already approved. When the user's request itself states the full scope ("these 5 contacts", "~30 companies", "everyone in this CSV"), the request IS the approval: pilot to validate quality and provider choice, then complete the stated scope, export to FINAL_CSV, and deliver — reporting cost and per-provider performance with the result, not as a blocking question. Do not stop to ask permission for work the user already sized — stopping delivers nothing.
Stop and ask only when the scope is open-ended ("build me a big list"), the pilot reveals a problem worth a decision (low coverage, wrong matches, high cost per usable row), or projected spend exceeds a budget the user stated. Then present pilot results, projected cost, and the recommended route, and wait.
deepline plays list --show-cost, the play's describe output, and the pilot's observed cost from deepline runs get <run-id> --full --json. State the estimate in the approval message. deepline plays run has no cap flag, and the runtime-enforced --max-credits-per-run <credits> ceiling exists only on the deprecated legacy surface — never describe a play cap as enforced; the pilot plus stated estimate is the control.When the user asks for N rows, start with ~1.4×N (e.g., 35 for 25). Every pipeline phase has natural falloff — contact search misses ~15-20% of companies, email waterfall misses ~5-10% of contacts. Fighting to complete the hard rows is almost always a waste: the companies that providers can't find contacts for are the same ones that won't have email coverage either.
Do this:
Do NOT do this:
deeplineagent research passes, or manual patching.deeplineagent research passes).Provider coverage is a property of the company, not something you can overcome with more effort. Tiny startups with 5 people will have zero coverage across all providers — no amount of retrying changes that. Over-provision at the top and let incomplete rows fall off naturally.
Include all of:
deepline runs export <pilot-run-id> --outApprove full run?Strict format contract (blocking):
AWAIT_APPROVAL and do not run paid/cost-unknown actions.FULL_RUN after an explicit user confirmation to the approval question.run_javascript is the non-AI path. ai_inference is for general classification/structured reasoning, and deeplineagent is for context gathering / web research / signal extraction.Approval template:
Assumptions
- <intent assumption 1>
- <intent assumption 2>
CSV Preview (ASCII)
<paste verbatim pilot output: the runs export head>
Credits + Scope + Cap
- Provider: <name>
- Estimated credits: <value or range>
- Full-run scope: <rows/items>
- Spend cap: <cap>
- Pilot summary: <one short paragraph>
Approval Question
Approve full run?deepline billing balance # Show current credit balance
deepline billing usage # Show recent billing activity and grouped recent usage
deepline billing limit # Show the current monthly billing capWhen credits are zero or unavailable, stop paid work and ask whether the user
wants to add Deepline credits. If the balance or failure output includes a
recovery object, quote its top_up_command and checkout_command exactly,
including --json and --no-open; do not run them until the user approves.
Do not hardcode a USD-to-credit exchange rate in the skill. Use live billing,
pricing, or tool output when quoting credit costs.
Quick-reference summary only — the Section 2 sub-doc you already read is the authority.
deepline tools search <intent> and execute field-matched provider calls in parallel; when the deepline-list-builder subagent is available, use subagent-based parallel search orchestration as the preferred pattern. Use deeplineagent only for synthesis or ambiguity resolution after the direct discovery path is exhausted.deepline plays run invocation, plus waterfall patterns and coalescing logic. Do not restate play internals from memory; treat the play itself as the source of truth for exact provider order and gating.run_javascript for deterministic transforms/template logic and deeplineagent for AI work. Start from prompts.json.leadmagic_email_validation first, then enrich corroboration.Before hand-rolling any pipeline a prebuilt might cover, deepline plays describe the candidate play and either use/wrap it or state the contract mismatch in one line. Silently bypassing a fitting prebuilt is a routing failure.
Provider path heuristics:
crustdata_person_enrichment, peopledatalabs_*) before leadmagic_* fallbacks.Critical: keep writing-outreach.md workflow context active when running any sequence task. It is not optional for ICP-driven messaging.
deepline update
deepline skillsSites requiring auth: Don't use Apify. Tell the user to use Claude in Chrome or guide them through Inspect Element to get a curl command with headers (user is non-technical).
deepline tools describe apify_run_actor_sync for the actor id, or try deepline tools search.supreme_coder/linkedin-post for generic posts/search URLs and harvestapi/linkedin-post-reactions when the goal is engagers/reactions. Avoid silentflow/linkedin-posts-scraper-ppr and alizarin_refrigerator-owner/linkedin-post-scraper unless the user explicitly asks for them.operatorNotes over public ratings when conflicting.deepline tools execute apify_list_store_actors --input '{"search":"linkedin company employees scraper","sortBy":"relevance","limit":20}'
deepline tools execute apify_get_actor_input_schema --input '{"actorId":"bebity/linkedin-jobs-scraper"}'Do not wait for the user to ask. If there is a meaningful failure, send feedback proactively using deepline feedback send.
Trigger when any of these happen:
Run once per issue cluster (avoid spam), and include:
deepline feedback send "Goal: <goal>. Tool/provider/model: <details>. Failure: <what broke>. Error: <exact message>. Repro attempted: <steps>."At the end of every completed run/session, ask exactly one Yes/No question:
Would you like me to send this session activity to the Deepline team so they can improve the experience? (Yes/No)
If user says:
deepline sessions send --current-sessionAsk once per completed run. Do not nag or re-ask unless the user starts a new run/session.
869569c
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.