### Setup Clay Extraction Environment

Source: https://github.com/getaero-io/gtm-eng-skills/blob/main/skills/deepline-gtm/references/clay-extraction.md

Sets up a Python virtual environment and installs the requests library for Clay extraction. It also includes the one-time authentication step by pasting a cURL command.

```bash
python3 -m venv .venv/clay-extract
.venv/clay-extract/bin/pip install requests

# Auth: paste a cURL from any api.clay.com request in Chrome DevTools
.venv/clay-extract/bin/python3 scripts/clay-extract.py --auth
```

--------------------------------

### Install Required Tools

Source: https://github.com/getaero-io/gtm-eng-skills/blob/main/examples/office-hours/tenant-enum/README.md

Install the necessary command-line tools for tenant enumeration. The primary path uses Homebrew, while a fallback option is mentioned for crt.sh.

```bash
# Primary path (recommended)
brew install subfinder httpx

# Fallback (no install needed, but crt.sh has frequent outages)
# pip install psycopg2-binary  # optional postgres fallback
```

--------------------------------

### Example ICP Context File

Source: https://github.com/getaero-io/gtm-eng-skills/blob/main/skills/deepline-gtm/writing-outreach.md

An example of an `icp.md` file defining ideal customer profile criteria and disqualifiers.

```markdown
# ICP

## Best-fit companies

- B2B SaaS, 200-500 employees, multi-product GTM team
- Uses modern data stack and CRM-based workflows

## Best-fit personas

- VP/Head/Director in Marketing, RevOps, Sales Ops, GTM Ops
- Owns pipeline quality, segmentation, scoring, or campaign orchestration

## Core pains

- Slow GTM iteration due to analyst/engineering dependency
- Low trust in black-box scoring
- Weak signal-to-action workflow for reps

## Disqualifiers

- <20 employees
- Pure B2C motion
- No clear sales/marketing operations function

```

--------------------------------

### Install All GTM Engineering Skills

Source: https://github.com/getaero-io/gtm-eng-skills/blob/main/llms.txt

Use this command to install all available GTM Engineering Skills. Ensure you have Node.js and npm installed.

```bash
npx skills add getaero-io/gtm-eng-skills --all
```

--------------------------------

### Executive Summary Example

Source: https://github.com/getaero-io/gtm-eng-skills/blob/main/skills/niche-signal-discovery/references/report-template.md

Provides an example format for the executive summary, profiling best-fit customers and listing prospective target companies.

```markdown
> {{Target}}'s buyers are mid-size companies (100-1000 employees) scaling {{domain}} operations. Top signals: hiring {{domain}}-related roles (3-5x lift), using {niche tools} (2-4x lift), mentioning "{buyer pain point}" (3-6x lift).
>
> **Companies that fit this profile but aren't customers yet:**
>
> - {Company A} ({{size}} employees) — {specific signal 1}, {specific signal 2}
> - {Company B} ({{size}} employees) — {specific signal 1}, {specific signal 2}
```

--------------------------------

### Install All GTM Skills Globally

Source: https://github.com/getaero-io/gtm-eng-skills/blob/main/README.md

Installs all skills globally, making them available across all projects on your system. Use with caution.

```bash
npx skills add getaero-io/gtm-eng-skills --all --global
```

--------------------------------

### Prepare Input CSV

Source: https://github.com/getaero-io/gtm-eng-skills/blob/main/skills/niche-signal-discovery/SKILL.md

Example CSV format for input data, including domain and status.

```csv
domain,status
customer1.com,won
non-customer1.com,lost
```

--------------------------------

### Install Specific GTM Skills

Source: https://github.com/getaero-io/gtm-eng-skills/blob/main/README.md

Installs only the specified skills from the repository. Useful when you only need a subset of the available skills.

```bash
npx skills add getaero-io/gtm-eng-skills --skill deepline-gtm build-tam linkedin-url-lookup
```

--------------------------------

### Start Play Run

Source: https://github.com/getaero-io/gtm-eng-skills/blob/main/skills/deepline-plays/references/api-reference.md

Starts a saved, prebuilt, or artifact-backed play run. This endpoint is used to initiate new executions of plays.

```APIDOC
## POST /api/v2/plays/run

### Description
Start a saved, prebuilt, or artifact-backed play run.

### Method
POST

### Endpoint
/api/v2/plays/run
```

--------------------------------

### Install Deepline CLI

Source: https://github.com/getaero-io/gtm-eng-skills/blob/main/llms.txt

Install the Deepline command-line interface globally. This is required for authentication and managing Deepline services.

```bash
npm install -g @deepline/cli
```

--------------------------------

### GET /api/v2/sdk/compat

Source: https://github.com/getaero-io/gtm-eng-skills/blob/main/skills/deepline-plays/references/api-reference.md

Checks SDK compatibility.

```APIDOC
## GET /api/v2/sdk/compat

### Description
Checks for SDK compatibility. This is an SDK-facing route.

### Method
GET

### Endpoint
/api/v2/sdk/compat
```

--------------------------------

### Install Deepline CLI and Skills from Claude Code

Source: https://github.com/getaero-io/gtm-eng-skills/blob/main/README.md

Use this prompt within Claude Code to install the Deepline CLI and associated skills. This is the recommended method for users interacting with Claude Code.

```plaintext
Install the Deepline CLI and skills using https://code.deepline.com/agent-install.txt
```

--------------------------------

### Install DeepLine CLI

Source: https://github.com/getaero-io/gtm-eng-skills/blob/main/skills/deepline-gtm/SKILL.md

Rerun the installer to ensure the latest CLI/client wiring is in place, which can help resolve unstable enrichment or CLI behavior.

```bash
curl -s "https://code.deepline.com/api/v2/cli/install" | bash
```

--------------------------------

### Start Play Run Stream

Source: https://github.com/getaero-io/gtm-eng-skills/blob/main/skills/deepline-plays/references/sdk-reference.md

Starts a play run and streams live runtime events directly. Use this for low-level event handling instead of submitting first and then connecting to `streamPlayRunEvents(runId)`.

```APIDOC
## startPlayRunStream

### Description
Start a play run and stream live runtime events from the same request.

Use this when a caller wants low-level event handling instead of submitting
first and then connecting to `streamPlayRunEvents(runId)`.

### Parameters
#### Path Parameters
None

#### Query Parameters
* **options** (object) - Optional - Streaming options.
  * **signal** (AbortSignal) - Optional - An AbortSignal to cancel the stream.

#### Request Body
* **request** (StartPlayRunRequest) - Required - Play run configuration.

### Returns / type
`AsyncGenerator<PlayLiveEvent>`
```

--------------------------------

### Get Webhooks

Source: https://github.com/getaero-io/gtm-eng-skills/blob/main/skills/deepline-gtm/provider-playbooks/lemlist.md

Retrieves a list of all configured webhooks.

```bash
deepline tools execute lemlist_get_webhooks --payload '{}'
```

--------------------------------

### Start Deepline Session

Source: https://github.com/getaero-io/gtm-eng-skills/blob/main/skills/deepline-quickstart/SKILL.md

Initiates a Deepline session with specified steps and an optional user prompt for telemetry.

```bash
deepline session start --steps '["Step 1", "Step 2"]' --user-prompt "Original user request"
```

--------------------------------

### Google Search Operator Example

Source: https://github.com/getaero-io/gtm-eng-skills/blob/main/skills/niche-signal-discovery/references/report-template.md

Table demonstrating Google search operators to verify specific signals for a company before outreach.

```markdown
| What to Check | Google Operator               | Positive Result Looks Like    |
| ------------- | ----------------------------- | ----------------------------- |
| [Signal name] | `site:domain.com "[keyword]"` | [What a positive match means] |
```

--------------------------------

### Example Workflow Visualization

Source: https://github.com/getaero-io/gtm-eng-skills/blob/main/README.md

Illustrates the flow of a user request through the Claude Code and Deepline skills, culminating in enriched data.

```text
You: "Find emails for the contacts in accounts.csv"
       │
       ▼
Claude Code picks the `deepline-gtm` skill and routes to the
right recipe + provider playbook for the task.
       │
       ▼
Skill runs the appropriate `deepline` CLI commands with the
provider waterfall, validation rules, and cost gates encoded
in the skill's instructions.
       │
       ▼
You get: enriched CSV with verified results + provider metadata
```

--------------------------------

### Example Claude Code Prompts for GTM Workflows

Source: https://github.com/getaero-io/gtm-eng-skills/blob/main/README.md

These examples demonstrate how to prompt Claude to initiate various GTM workflows using the installed Deepline skills. Claude automatically selects the appropriate skill based on the request.

```plaintext
> "Build a TAM of VP Sales at 50-500 person SaaS companies in the US"
> "Find LinkedIn URLs for the contacts in my CSV with identity validation"
> "Find companies in a16z's portfolio and get the Head of Growth at each"
```

--------------------------------

### Sample Sequence Copy - Day 0 Welcome

Source: https://github.com/getaero-io/gtm-eng-skills/blob/main/workflows/inbound-qualification-saas/README.md

Example email copy for the Day 0 welcome message in a HubSpot sequence. Includes placeholders for product name, rep name, and calendar link.

```email
Hi {{ contact.firstname }},

It's <REP> from <PRODUCT>. Glad you signed up. Let me know if you have any questions as you get going.

If you want to hop on a quick call to talk through how to get the most value out of the platform, here's my calendar: <CAL_LINK>

What's the one outbound or enrichment problem you're hoping to solve first?

<REP>
```

--------------------------------

### Get Tool (Alternative)

Source: https://github.com/getaero-io/gtm-eng-skills/blob/main/skills/deepline-plays/references/api-reference.md

Retrieves a detailed description of a specific provider-backed tool, including schema, pricing, and guidance.

```APIDOC
## GET /api/v2/integrations/:toolId/get

### Description
Fetches comprehensive details for a given tool, identified by `toolId`. This endpoint provides schema, pricing, guidance, and extractor information for the tool.

### Method
GET

### Endpoint
/api/v2/integrations/:toolId/get

### Parameters
#### Path Parameters
- **toolId** (string) - Required - The unique identifier for the tool integration.

### Response
#### Success Response (200)
- Returns the detailed definition of the specified tool.

#### Response Example
```json
{
  "id": "tool-id-1",
  "name": "Example Tool",
  "description": "An example tool.",
  "schema": { ... },
  "pricing": { ... },
  "guidance": "..."
}
```
```

--------------------------------

### Describe Play for Agents/CLIs

Source: https://github.com/getaero-io/gtm-eng-skills/blob/main/skills/deepline-plays/references/sdk-reference.md

Gets a normalized play description suitable for agents and CLIs. Includes runnable examples, input/output summaries, and revision state.

```javascript
describePlay("my-play-name")
```

--------------------------------

### Set Up Working Directory for Org Chart Data

Source: https://github.com/getaero-io/gtm-eng-skills/blob/main/skills/deepline-gtm/recipes/account-orgchart.md

Initializes a working directory and creates a CSV file for account data. Use a descriptive, task-named directory for easy output retrieval.

```bash
WORK_DIR="deepline/data/${COMPANY_SLUG}-orgchart"   # e.g. deepline/data/ramp-orgchart
mkdir -p "$WORK_DIR"
echo "company_domain,company_name" > "$WORK_DIR/accounts.csv"
echo "\"$DOMAIN\",\"$COMPANY\"" >> "$WORK_DIR/accounts.csv"
```

--------------------------------

### Get, Update, and Delete Smartlead Campaigns

Source: https://github.com/getaero-io/gtm-eng-skills/blob/main/skills/deepline-gtm/provider-playbooks/smartlead.md

Commands to retrieve details of a specific campaign, start or stop it, and remove it. Always verify the campaign ID before performing update or delete operations.

```bash
deepline tools execute smartlead_get_campaign --payload '{"campaign_id":12345678}'
```

```bash
deepline tools execute smartlead_update_campaign_status --payload '{"campaign_id":12345678,"status":"START"}'
```

```bash
deepline tools execute smartlead_delete_campaign --payload '{"campaign_id":12345678}'
```

--------------------------------

### Set Up Local Working Directory

Source: https://github.com/getaero-io/gtm-eng-skills/blob/main/skills/deepline-gtm/SKILL.md

Establishes a project-local working directory to prevent data loss from system temporary file wipes. Use a descriptive slug for the task.

```bash
WORKDIR="deepline/data/<descriptive-task-slug>" && mkdir -p "$WORKDIR" && echo "$WORKDIR"
```

--------------------------------

### describePlay

Source: https://github.com/getaero-io/gtm-eng-skills/blob/main/skills/deepline-plays/references/sdk-reference.md

Gets a normalized play description suitable for agents and CLIs. The description includes runnable examples, input/output summaries, clone guidance, revision state, and latest run metadata when available.

```APIDOC
## describePlay

### Description
Get a normalized play description suitable for agents and CLIs.

### Method
`describePlay(name: string, options?: { compact?: boolean })`

### Parameters
#### Path Parameters
- **name** (string) - Play name

### Returns
`Promise<PlayDescription>`
```

--------------------------------

### Run Prebuilt Play

Source: https://github.com/getaero-io/gtm-eng-skills/blob/main/skills/deepline-plays/references/run-export-inspect-repair.md

Execute a prebuilt deepline play with specified input and watch for progress.

```bash
deepline plays run prebuilt/<name> --input '{...}' --watch
```

--------------------------------

### List and Create Smartlead Campaigns

Source: https://github.com/getaero-io/gtm-eng-skills/blob/main/skills/deepline-gtm/provider-playbooks/smartlead.md

Use these commands to list existing campaigns or create a new one with a specified name. Ensure you have the necessary permissions and that the campaign name is descriptive.

```bash
deepline tools execute smartlead_list_campaigns --payload '{}'
```

```bash
deepline tools execute smartlead_create_campaign --payload '{"name":"Insurance Brokerage - Book Assessment"}'
```

--------------------------------

### Start a New Session with Execution Plan

Source: https://github.com/getaero-io/gtm-eng-skills/blob/main/skills/deepline-gtm/SKILL.md

Initiate a new task session by publishing an execution plan. The plan, a JSON array of step labels, is crucial for real-time progress monitoring in the Session UI. This command accepts the plan and an optional user prompt.

```bash
deepline session start --steps '["Inspect CSV and understand shape","Search for email finder tools","Run pilot on rows 0:1","Get approval for full run","Execute full enrichment","Post-run validation and delivery"]' --user-prompt "Original user request"
```

--------------------------------

### Get Company Search Totals

Source: https://github.com/getaero-io/gtm-eng-skills/blob/main/skills/deepline-gtm/finding-companies-and-contacts.md

Use to get the total count of organizations matching a given industry.

```bash
deepline tools execute forager_organization_search_totals --payload '{"industries":[1]}'
```

--------------------------------

### Search Deepline tools for investors

Source: https://github.com/getaero-io/gtm-eng-skills/blob/main/skills/deepline-gtm/SKILL.md

Initiate signal-driven discovery by searching Deepline tools. This example searches for investor-related signals. Consider using prefixes for more specific searches.

```bash
deepline tools search investor
```

```bash
deepline tools search investor --prefix crustdata
```

--------------------------------

### Show CSV sample

Source: https://github.com/getaero-io/gtm-eng-skills/blob/main/skills/deepline-gtm/SKILL.md

Use this command to display a sample of CSV content, such as the first two rows, for exploration without loading the entire file into context.

```bash
deepline csv show --csv <path> --rows 0:2
```

--------------------------------

### Dependency Graph Example (Mermaid)

Source: https://github.com/getaero-io/gtm-eng-skills/blob/main/skills/deepline-gtm/recipes/clay-to-deepline.md

Visualizes the dependencies between data fields and processing steps using Mermaid syntax. Use specific class definitions for local, remote, and AI tools.

```mermaid
graph TD
    A[record_id] --> B[clay_record]
    B --> C[fields]
    C --> D[exa_research]
    D --> E[strategic_initiatives]
    C --> F[qualify_person]
    E --> F
```

--------------------------------

### Typed Semantic Query Payload Example

Source: https://github.com/getaero-io/gtm-eng-skills/blob/main/skills/deepline-analytics/SKILL.md

An example of a typed payload for the semantic query API, specifying metrics, dimensions, and filters.

```json
{
  "type": "metrics",
  "params": {
    "table_name": "OPPORTUNITY",
    "metrics": ["num_opportunities"],
    "dimensions": ["close_quarter_label"],
    "filters": ["exclude_renewal_opportunities"]
  },
  "rowLimit": 100
}
```

--------------------------------

### Start A Named Or Prebuilt Play

Source: https://github.com/getaero-io/gtm-eng-skills/blob/main/skills/deepline-plays/references/api-reference.md

Initiates the execution of a named or prebuilt play with specified input parameters. Returns a workflow ID to track the run's progress.

```APIDOC
## POST /api/v2/plays/run

### Description
Starts a new play execution with a given name and input. The response includes a `workflowId` for tracking.

### Method
POST

### Endpoint
/api/v2/plays/run

### Parameters
#### Request Body
- **name** (string) - Required - The name of the play to run (e.g., "prebuilt/person-linkedin-to-email").
- **input** (object) - Required - A JSON object containing the input parameters for the play.
  - **linkedin_url** (string) - Optional - LinkedIn profile URL.
  - **first_name** (string) - Optional - First name.
  - **last_name** (string) - Optional - Last name.
  - **company_name** (string) - Optional - Company name.
  - **domain** (string) - Optional - Domain name.

### Request Example
```json
{
  "name": "prebuilt/person-linkedin-to-email",
  "input": {
    "linkedin_url": "https://www.linkedin.com/in/example-person/",
    "first_name": "Jane",
    "last_name": "Smith",
    "company_name": "ExampleCo",
    "domain": "example.com"
  }
}
```

### Response
#### Success Response (200)
- **workflowId** (string) - The unique identifier for the play run.
- **apiVersion** (integer) - The API version used.
- **status** (string) - The initial status of the run (e.g., "running").
- **dashboardUrl** (string) - A URL to view the run in the Deepline dashboard.

#### Response Example
```json
{
  "workflowId": "play_run_...",
  "apiVersion": 2,
  "status": "running",
  "dashboardUrl": "https://code.deepline.com/dashboard/plays/..."
}
```
```

--------------------------------

### Execute Adyntel Google Shopping Sync Playbook

Source: https://github.com/getaero-io/gtm-eng-skills/blob/main/skills/deepline-gtm/provider-playbooks/adyntel.md

Initiates and polls Google Shopping data for a specified company domain. Prefer this for launching and monitoring Google Shopping data collection in a single operation.

```bash
deepline tools execute adyntel_google_shopping_sync --payload '{"company_domain":"allbirds.com"}'
```

--------------------------------

### Workflow Steps for Warm Intro Scoring

Source: https://github.com/getaero-io/gtm-eng-skills/blob/main/examples/office-hours/warm-intro-scoring/blog_post.md

Outlines the practical steps involved in the warm introduction scoring workflow, from data export to final review.

```text
1. Export LinkedIn connections CSV
2. Ingest into SQLite via warm_intro ingest script (6,484 contacts, ~2 min)
3. Filter to connections at target companies (94 contacts)
4. Enrich job histories via Edges (94 × 0.6 credits = $1.09, ~2 min)
5. Run scorer against each target (instant, in-memory)
6. Review top results, pick connectors, draft the ask
```

--------------------------------

### getRunStatus

Source: https://github.com/getaero-io/gtm-eng-skills/blob/main/skills/deepline-plays/references/sdk-reference.md

Gets a run by ID using the public runs resource model. This is the SDK equivalent of `deepline runs get <run-id> --json`.

```APIDOC
## getRunStatus

### Description
Get a run by id using the public runs resource model. This is the SDK equivalent of:

```bash
deeline runs get <run-id> --json
```

### Method
`getRunStatus(runId: string, options?: { full?: boolean })

### Parameters
#### Path Parameters
- **runId** (string) - Required - The ID of the run.

#### Query Parameters
- **full** (boolean) - Optional - Whether to return full status details.

### Response
#### Success Response
- **PlayStatus** - The status of the run.
```

--------------------------------

### Direct Prebuilt Run Commands

Source: https://github.com/getaero-io/gtm-eng-skills/blob/main/skills/deepline-plays/SKILL.md

Commands for describing, running, and exporting results from prebuilt Deepline plays. Use for direct execution when input matches exactly and no complex mapping is needed.

```bash
deepline plays describe prebuilt/<name> --json
deeline plays run prebuilt/<name> --input '{"field":"value"}' --watch
deeline runs get <run-id> --full --json
deeline runs export <run-id> --dataset result.rows --out rows.csv
```

--------------------------------

### Add Leads to a Campaign with Instantly

Source: https://github.com/getaero-io/gtm-eng-skills/blob/main/skills/deepline-gtm/provider-playbooks/instantly.md

Execute the command to add leads to a specific campaign. Requires campaign ID and lead details including email, first name, and last name.

```bash
deepline tools execute instantly_add_to_campaign --payload '{"campaign_id":"abc-123","leads":[{"email":"ada@example.com","first_name":"Ada","last_name":"Lovelace","company_name":"Babbage Ltd"}]}'
```

--------------------------------

### Get Email Count for a Domain

Source: https://github.com/getaero-io/gtm-eng-skills/blob/main/skills/deepline-gtm/finding-companies-and-contacts.md

Use to get a rough estimate of email count for a given domain. Note that this does not represent reachable persona count.

```bash
deepline tools execute hunter_email_count --payload '{"domain":"stripe.com"}'
```

--------------------------------

### Legacy Flat Semantic Query Payload Example

Source: https://github.com/getaero-io/gtm-eng-skills/blob/main/skills/deepline-analytics/SKILL.md

An example of the legacy flat metrics payload for the semantic query API. Use this when the typed form is not applicable.

```json
{
  "table_name": "OPPORTUNITY",
  "metrics": ["num_opportunities"],
  "dimensions": ["close_quarter_label"],
  "rowLimit": 100
}
```

--------------------------------

### startPlayRunFromBundle

Source: https://github.com/getaero-io/gtm-eng-skills/blob/main/skills/deepline-plays/references/sdk-reference.md

Registers an already-bundled play artifact and initiates a run from it. This is the low-level file-backed run path used by SDK/CLI packaging wrappers after local bundling has produced the runtime artifact.

```APIDOC
## startPlayRunFromBundle

### Description
Registers an already-bundled play artifact and initiates a run from it. This is the low-level file-backed run path used by SDK/CLI packaging wrappers after local bundling has produced the runtime artifact.

### Method
method

### Parameters
#### Request Body
- **input** (object) - Required - 
  - **name** (string) - Required - 
  - **sourceCode** (string) - Required - 
  - **sourceFiles** (object) - Optional - 
  - **artifact** (object) - Required - 
  - **compilerManifest** (object) - Optional - 
  - **input** (object) - Optional - 
  - **inputFile** (object) - Optional - 
  - **packagedFiles** (array) - Optional - 
  - **force** (boolean) - Optional - 

### Response
#### Success Response
- **PlayRunStart** (object) - Required - 
```

--------------------------------

### List Campaigns with Instantly

Source: https://github.com/getaero-io/gtm-eng-skills/blob/main/skills/deepline-gtm/provider-playbooks/instantly.md

Execute the command to list available campaigns using the Instantly provider. The payload is an empty JSON object.

```bash
deepline tools execute instantly_list_campaigns --payload '{}'
```

--------------------------------

### Install Deepline CLI from Command Line

Source: https://github.com/getaero-io/gtm-eng-skills/blob/main/README.md

Installs the Deepline CLI directly from the command line using a curl command. This is useful for setting up the CLI environment outside of Claude Code.

```bash
curl -fsSL "https://code.deepline.com/api/v2/cli/install" | bash
```

--------------------------------

### Complete People Search Filter Example

Source: https://github.com/getaero-io/gtm-eng-skills/blob/main/skills/deepline-gtm/provider-playbooks/ai_ark.md

A comprehensive example demonstrating filters for account domain, contact experience title, seniority, and location. This structure is critical for accurate people searches.

```json
{
  "page": 0,
  "size": 25,
  "account": {
    "domain": {
      "any": {
        "include": ["acme.com", "example.com"]
      }
    }
  },
  "contact": {
    "experience": {
      "current": {
        "title": {
          "any": {
            "include": {
              "mode": "SMART",
              "content": ["VP of Sales", "Head of Sales"]
            }
          }
        }
      }
    },
    "seniority": {
      "any": {
        "include": ["vp", "director"]
      }
    },
    "location": {
      "any": {
        "include": ["San Francisco"]
      }
    }
  }
}
```

--------------------------------

### Launch Playground for Configuration Review

Source: https://github.com/getaero-io/gtm-eng-skills/blob/main/skills/niche-signal-discovery/SKILL.md

Use the deepline playground to review enriched data and identify potential issues with keyword targeting or product categories.

```bash
deepline playground output/{{company}}-enriched.csv
```

--------------------------------

### Set Initial Step Status to Running

Source: https://github.com/getaero-io/gtm-eng-skills/blob/main/skills/deepline-gtm/SKILL.md

Immediately after posting the plan, set the first step's status to 'running'. This indicates that the task has begun processing.

```bash
deepline session start --update 0 --status running
```

--------------------------------

### List Supported Platforms

Source: https://github.com/getaero-io/gtm-eng-skills/blob/main/examples/office-hours/tenant-enum/README.md

Use the ct_harvest.py script to list all supported SaaS platforms for enumeration.

```bash
python3 ct_harvest.py --list
```

--------------------------------

### Playbook 4: Batch Import Workflow

Source: https://github.com/getaero-io/gtm-eng-skills/blob/main/skills/deepline-gtm/provider-playbooks/attio.md

This playbook outlines a strategy for batch importing records into Attio. It emphasizes respecting rate limits for record assertions and entry creations, and setting up webhooks for enrichment tracking.

```text
1. Loop: attio_assert_record -> upsert each record (respect 25 writes/sec)
2. Loop: attio_create_entry  -> add to pipeline (respect 25 writes/sec)
3. attio_create_webhook      -> subscribe to record.updated for enrichment tracking
```

--------------------------------

### Ground Truth Data Example

Source: https://github.com/getaero-io/gtm-eng-skills/blob/main/skills/deepline-gtm/references/cloud-workflow-migrations.md

Example of representative rows extracted from source data to establish ground truth for workflow migration. This JSON structure includes labels, inputs, and expected outputs for validation.

```json
[
  {
    "label": "Kurt Lohse — CPG qualified, score 10",
    "input": {
      "first_name": "Kurt",
      "email": "kurt@boredandthirsty.com",
      "...": "..."
    },
    "expected": {
      "cpg_company": true,
      "total_score": 10,
      "status": "create_deal",
      "category": "POSITIVE_INTEREST"
    }
  }
]
```

--------------------------------

### Vertical Examples for Persona Job Titles

Source: https://github.com/getaero-io/gtm-eng-skills/blob/main/skills/niche-signal-discovery/references/step-7-prospects.md

These examples provide specific job titles for various verticals that can be used with the `--roles` argument in the `find_contacts.py` script. Substitute the relevant persona titles from your Step 0.5 analysis.

```bash
# Vertical examples (substitute the persona that came out of YOUR Step 0.5):
#   creative ops:   "Creative Director,Brand Manager,Content Operations Lead,Marketing Operations"
#   AR automation:  "AR Manager,Accounts Receivable Specialist,Controller,Finance Director"
#   sales engagement: "SDR Manager,Sales Operations,VP Sales,Head of Sales Development"
#   developer tools: "Staff Engineer,Platform Engineer,DevOps Lead,Engineering Manager"
#   metal AM (the run that motivated this skill): "Design Engineer,Mechanical Design Engineer,Additive Manufacturing Engineer,DfAM Engineer"
```

--------------------------------

### Minimal Folder Layout for Context Pack

Source: https://github.com/getaero-io/gtm-eng-skills/blob/main/skills/deepline-gtm/writing-outreach.md

This structure shows the recommended organization for context files used by the skill.

```text
./context/
  icp.md
  qualification_questions.md
  product_context.md
  copy_rules.md
```

--------------------------------

### GET /api/v2/workflows

Source: https://github.com/getaero-io/gtm-eng-skills/blob/main/skills/deepline-plays/references/api-reference.md

Lists all available workflows.

```APIDOC
## GET /api/v2/workflows

### Description
Lists all available workflows. This is an SDK-facing route.

### Method
GET

### Endpoint
/api/v2/workflows
```

--------------------------------

### Custom SQL Dimensions Example

Source: https://github.com/getaero-io/gtm-eng-skills/blob/main/skills/deepline-analytics/SKILL.md

Illustrates how to use custom SQL for dimensions, such as truncating a date to the month, with the correct expression-first format.

```text
DATE_TRUNC('month', close_date) AS close_month
```

--------------------------------

### GET /api/v2/secrets

Source: https://github.com/getaero-io/gtm-eng-skills/blob/main/skills/deepline-plays/references/api-reference.md

Lists or checks secrets.

```APIDOC
## GET /api/v2/secrets

### Description
Lists or checks secrets. This is an SDK-facing route.

### Method
GET

### Endpoint
/api/v2/secrets
```

--------------------------------

### Create Campaign

Source: https://github.com/getaero-io/gtm-eng-skills/blob/main/skills/deepline-gtm/provider-playbooks/lemlist.md

Creates a new campaign in Lemlist. The response includes a `web_url` for UI review.

```bash
deepline tools execute lemlist_create_campaign --payload '{"name":"My Campaign"}'
```

--------------------------------

### List all workflows

Source: https://github.com/getaero-io/gtm-eng-skills/blob/main/skills/deepline-gtm/references/cloud-workflow-builder.md

Use this command to see all existing workflows in JSON format. This helps in understanding the current workflow landscape and identifying potential patterns or existing solutions.

```bash
deepline workflows list --json
```

--------------------------------

### Deploy Slack Button Listener Workflow

Source: https://github.com/getaero-io/gtm-eng-skills/blob/main/workflows/slack-button-listener/README.md

Steps to deploy the Deepline workflow, including editing configuration, applying the workflow, and wiring Slack interactivity.

```bash
# 1. Edit workflow.json:
#    - Replace SLACK_CHANNELS / channel id mappings if needed
#    - Replace REPLACE_ME_CHANNEL_ID with your inbound channel's actual ID
#    - Replace REPLACE_ME_INBOUND_CHANNEL with the channel name (#-prefixed)

# 2. Apply:
deeline workflows apply --payload "$(cat workflow.json)" --json

# 3. Wire Slack:
#    api.slack.com/apps → your app → Interactivity & Shortcuts
#    - Toggle Interactivity ON
#    - Request URL: <webhook URL printed by step 2>
#    - Save
#    Re-install the app to the workspace if Slack prompts you.
```

--------------------------------

### GET /api/v2/billing/usage

Source: https://github.com/getaero-io/gtm-eng-skills/blob/main/skills/deepline-plays/references/api-reference.md

Retrieves billing usage statistics.

```APIDOC
## GET /api/v2/billing/usage

### Description
Retrieves billing usage statistics. This is an SDK-facing route.

### Method
GET

### Endpoint
/api/v2/billing/usage
```

--------------------------------

### Start A Named Or Prebuilt Play

Source: https://github.com/getaero-io/gtm-eng-skills/blob/main/skills/deepline-plays/references/api-reference.md

Initiates a play run by sending a POST request to the /api/v2/plays/run endpoint. Requires the play name and input parameters. The response includes a workflowId to track the run.

```bash
curl -X POST "$DEEPLINE_HOST_URL/api/v2/plays/run" \
  -H "Authorization: Bearer $DEEPLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ 
    "name": "prebuilt/person-linkedin-to-email",
    "input": {
      "linkedin_url": "https://www.linkedin.com/in/example-person/",
      "first_name": "Jane",
      "last_name": "Smith",
      "company_name": "ExampleCo",
      "domain": "example.com"
    }
  }'
```

--------------------------------

### GET /api/v2/billing/limit

Source: https://github.com/getaero-io/gtm-eng-skills/blob/main/skills/deepline-plays/references/api-reference.md

Retrieves current billing limits.

```APIDOC
## GET /api/v2/billing/limit

### Description
Retrieves the current billing limits. This is an SDK-facing route.

### Method
GET

### Endpoint
/api/v2/billing/limit
```

--------------------------------

### GET /api/v2/billing/ledger

Source: https://github.com/getaero-io/gtm-eng-skills/blob/main/skills/deepline-plays/references/api-reference.md

Retrieves the billing history ledger.

```APIDOC
## GET /api/v2/billing/ledger

### Description
Retrieves the billing history ledger. This is an SDK-facing route.

### Method
GET

### Endpoint
/api/v2/billing/ledger
```

--------------------------------

### GET /api/v2/billing/balance

Source: https://github.com/getaero-io/gtm-eng-skills/blob/main/skills/deepline-plays/references/api-reference.md

Retrieves the current billing balance.

```APIDOC
## GET /api/v2/billing/balance

### Description
Retrieves the current billing balance. This is an SDK-facing route.

### Method
GET

### Endpoint
/api/v2/billing/balance
```

--------------------------------

### Search and Describe Deepline Plays and Tools

Source: https://github.com/getaero-io/gtm-eng-skills/blob/main/skills/deepline-plays/SKILL.md

Use these commands to find and get details about available plays and tools. Always describe a candidate before using it.

```bash
deepline plays search "<job words>" --json
```

```bash
deepline plays describe prebuilt/<candidate> --json
```

```bash
deepline tools search "<provider need>" --categories <category> --json
```

```bash
deepline tools describe <tool-id> --json
```

--------------------------------

### GET /api/v2/workflows/:id/runs

Source: https://github.com/getaero-io/gtm-eng-skills/blob/main/skills/deepline-plays/references/api-reference.md

Lists all runs for a specific workflow.

```APIDOC
## GET /api/v2/workflows/:id/runs

### Description
Lists all runs for a specific workflow. This is an SDK-facing route.

### Method
GET

### Endpoint
/api/v2/workflows/:id/runs
```

--------------------------------

### Configure Smartlead Campaign Sequences

Source: https://github.com/getaero-io/gtm-eng-skills/blob/main/skills/deepline-gtm/provider-playbooks/smartlead.md

Fetch existing sequences or define new ones, including email steps, delays, and variants. Ensure sequences are configured before starting a campaign.

```bash
deepline tools execute smartlead_fetch_campaign_sequences --payload '{"campaign_id":12345678}'
```

```bash
deepline tools execute smartlead_save_campaign_sequences --payload '{"campaign_id":12345678,"sequences":[{"seq_number":1,"seq_delay_details":{"delay_in_days":0},"seq_variants":[{"email_body":"<p>Hello Ada</p>","variant_label":"A","subject":"Quick question"}]},{
```

```bash
seq_number":2,"seq_delay_details":{"delay_in_days":3},"seq_variants":[{"email_body":"<p>Following up</p>","variant_label":"A","subject":"Re: Quick question"}]}]}'
```

--------------------------------

### GET /api/v2/workflows/:id

Source: https://github.com/getaero-io/gtm-eng-skills/blob/main/skills/deepline-plays/references/api-reference.md

Retrieves details of a specific workflow.

```APIDOC
## GET /api/v2/workflows/:id

### Description
Retrieves the details of a specific workflow by its ID. This is an SDK-facing route.

### Method
GET

### Endpoint
/api/v2/workflows/:id
```

--------------------------------

### Bootstrap, Wrap, and Fork Commands

Source: https://github.com/getaero-io/gtm-eng-skills/blob/main/skills/deepline-plays/SKILL.md

Commands for composing plays using bootstrap, inspecting prebuilt plays for forking, and checking bootstrapped workflows. Use bootstrap for mapping CSV headers or when a prebuilt is a stage. Fork when internal logic needs changes.

```bash
deepline plays bootstrap <family> --from <source> --using play:prebuilt/<candidate> --limit 5 --out workflow.play.ts
deeline plays get prebuilt/<name> --source --out fork.play.ts
deeline plays check workflow.play.ts
```

--------------------------------

### listWorkflows

Source: https://github.com/getaero-io/gtm-eng-skills/blob/main/skills/deepline-plays/references/sdk-reference.md

Lists the organization's workflows. Equivalent to `GET /api/v2/workflows`.

```APIDOC
## listWorkflows

### Description
List the org's workflows. `GET /api/v2/workflows`.

### Method
`listWorkflows(options?: { limit?: number })

### Parameters
#### Query Parameters
- **limit** (number) - Optional - The maximum number of workflows to return.

### Response
#### Success Response
- **{ workflows: Array<{ id: string; name: string; status: string; current_published_version: number | null; }>; }** - An object containing a list of workflows.
```