Run the GTM-OS 7-gate qualification pipeline over a batch of leads from a CSV, JSON, Notion DB, profile-visitors export, post-engagers export, or an existing SQLite result set.

MITAuto-check: notesMarketing & SEO

Install Qualify Leads

skills CLI
$ npx skills add Othmane-Khadri/YALC-the-GTM-operating-system --skill qualify-leads -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Othmane-Khadri/YALC-the-GTM-operating-system qualify-leads --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/Othmane-Khadri/YALC-the-GTM-operating-system.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/qualify-leads .claude/skills/qualify-leads && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
qualify-leads
GitHub stars
317
Token cost
~1.4k tokens
SKILL.md length
630 words
Files
2 (incl. references)
Skills in repo
57
Repo updated
First seen
Licence
MIT

At a glance

Run the GTM-OS 7-gate qualification pipeline over a batch of leads from a CSV, JSON, Notion DB, profile-visitors export, post-engagers export, or an existing SQLite result set.

  • Works in 6 steps: Ask for input → Validate the input locally → Shell out → …
  • The user says qualify these leads
  • SKILL.md covers When This Skill Applies, What This Skill Does, What This Skill Does NOT and Pre-flight (do this before…, plus 3 more sections
  • Calls npx

What it does

Qualify Leads is an agent skill from Othmane-Khadri/YALC-the-GTM-operating-system. Run the GTM-OS 7-gate qualification pipeline over a batch of leads from a CSV, JSON, Notion DB, profile-visitors export, post-engagers export, or an existing SQLite result set. Writes per-lead pass/fail data back into SQLite and returns a result-set id you can hand to the campaign launcher. Use when the user says 'qualify these leads', 'score this lead list', 'run the qualification pipeline', 'check if these leads are a fit', or 'qualify the engagers'. Side-effecting — writes to the local SQLite db.

Its SKILL.md is about 1.4k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including reference files (for example `references/example-output.md`).

It sits in Marketing & SEO, covering Go-to-market strategy and CSV and tabular files. It works with SQLite, Notion and LinkedIn. The repository describes itself as: YALC 1.0, the open-source Clay alternative. MIT, CLI-first, self-hosted, runs in Claude Code. Yalc today is an intelligent orchestration layer that runs pre configured GTM agents…. The licence is MIT.

When your agent uses it

  • The user says qualify these leads
  • Score this lead list
  • Run the qualification pipeline
  • Check if these leads are a fit

Example prompts

  • “qualify these leads”
  • “score this lead list”
  • “run the qualification pipeline”
  • “/qualify-leads”

Requirements

  • Node.js

Workflow steps

6 steps, taken from the step headings in SKILL.md.

  1. Ask for input
  2. Validate the input locally
  3. Shell out
  4. Parse the output
  5. Render
  6. Offer follow-ups

What it can do on your machine

Read from SKILL.md and the folder at commit 5686d1f. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • npx

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use npx, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Qualify Leads loads about 1.4k tokens when it runs, and up to ~1.9k if it reads all its reference files. Until then it costs about 130 tokens; SKILL.md has 630 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~130
When it runs · the whole SKILL.md, loaded when a task matches
~1.4k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~1.9k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteMentions a .env fileSKILL.md:42
    - Modify any `.env` file. If a key is missing, the CLI raises and we surface its stderr verbatim.
  • NoteMentions a .env fileSKILL.md:83
    cd ~/Desktop/gtm-os && set -a && source .env.local && set +a && \
  • NoteMentions a .env fileSKILL.md:90
    cd ~/Desktop/gtm-os && set -a && source .env.local && set +a && \

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from Othmane-Khadri/YALC-the-GTM-operating-system at commit 5686d1f, republished under its MIT licence (© Othmane-Khadri). 630 words, ~1,398 tokens.

Download SKILL.mdSave it as .claude/skills/qualify-leads/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
qualify-leads
description
Run the GTM-OS 7-gate qualification pipeline over a batch of leads from a CSV, JSON, Notion DB, profile-visitors export, post-engagers export, or an existing SQLite result set. Writes per-lead pass/fail data back into SQLite and returns a result-set id you can hand to the campaign launcher. Use when the user says 'qualify these leads', 'score this lead list', 'run the qualification pipeline', 'check if these leads are a fit', or 'qualify the engagers'. Side-effecting — writes to the local SQLite db.
version
1.0.0

Qualify Leads

I'll wrap leads:qualify. I'll ask for the input source and path, validate locally, run the CLI, parse the per-gate counts, and surface the result-set id so you can hand it to launch-linkedin-campaign or personalize-message.

When This Skill Applies

Use this skill when the user says:

  • "qualify these leads"
  • "score this lead list"
  • "run the qualification pipeline"
  • "check if these leads are a fit"
  • "qualify the engagers"

NOT this skill (use personalize-message instead):

  • "personalize a message for this lead" — that wraps the personalize CLI and writes a single LinkedIn DM, it doesn't run the gate pipeline.
  • "draft a DM for [lead]" — same.

NOT this skill (use scrape-post-engagers instead):

  • "scrape engagers off this LinkedIn post" — that wraps leads:scrape-post. Run that first to produce an engagers JSON, then come back here to qualify it.

What This Skill Does

  1. Asks where the leads live (CSV path, JSON path, Notion DB id, visitors export, engagers export, or an existing result-set id).
  2. Validates the input locally — file exists, Notion id has the right shape, result-set id format looks plausible.
  3. Shells out to npx tsx src/cli/index.ts leads:qualify <args> from ~/Desktop/gtm-os/.
  4. Parses the CLI's stdout — the pipeline emits per-gate counters and the resultSetId.
  5. Renders a clean per-gate summary, the result-set id, and the top hot leads.
  6. Offers two follow-up moves: launch a campaign or personalize messages.

What This Skill Does NOT

  • Send any outbound messages. That's launch-linkedin-campaign (LinkedIn) or send-cold-email (email).
  • Author personalized message bodies. That's personalize-message.
  • Re-import data that's already a result set. If the user already has a resultSetId, pass --result-set <id> and skip --source / --input.
  • Modify any .env file. If a key is missing, the CLI raises and we surface its stderr verbatim.

Pre-flight (do this before step 1)

  1. Onboarding interruption guard. Run:

    bash
    test -f ~/.gtm-os/.in-flight-setup && echo "BLOCKED" || echo "OK"

    If BLOCKED, stop. Tell the user: "Setup is mid-flight. Finish yalc-gtm start first, then re-invoke me." Exit cleanly.

  2. Confirm cwd. All shell-outs assume ~/Desktop/gtm-os/.

Workflow

Step 0 — Ask for input

One question at a time:

  1. Where do the leads live? Five options:

    • CSV path (--source csv --input <path>)
    • JSON path (--source json --input <path>)
    • Notion DB id (--source notion --input <db-id>)
    • Profile-visitors export (--source visitors --input <path>)
    • Post-engagers export (--source engagers --input <path>)
    • Or "use the most recent result set" / a specific id (--result-set <id>, no --source / --input)
  2. Any toggles? Ask only if volunteered:

    • --dry-run — preview without writing
    • --no-dedup — skip dedup gate
    • --slack-confirm — Slack for ambiguous dedup matches
    • --enrich-signals (+ --signals-types <jobs,funding,tech,news>) — pull PredictLeads after qualify
Show full SKILL.md (215 more words)Show less
Step 1 — Validate the input locally
  • For csv / json / visitors / engagers: test -f <path> returns 0.
  • For notion: 32-char hex (with or without dashes). Extract id from URL if needed.
  • For --result-set <id>: format looks plausible.
Step 2 — Shell out
bash
cd ~/Desktop/gtm-os && set -a && source .env.local && set +a && \
  npx tsx src/cli/index.ts leads:qualify --source <type> --input <path>

…or for an existing result set:

bash
cd ~/Desktop/gtm-os && set -a && source .env.local && set +a && \
  npx tsx src/cli/index.ts leads:qualify --result-set <id>

Per the merged 0.13.0 benchmark in docs/skills-architecture.md, single-command side-effecting skills shell out unconditionally. The CLI is the source of truth for env loading, tenant resolution, and the withDiagnostics() wrapper.

Step 3 — Parse the output

leads:qualify writes [qualify] log lines to stdout, one per gate, plus the result-set id and survivor count. On non-zero exit, surface stderr verbatim — no summarising.

Step 4 — Render

Show the per-gate funnel, result-set id, and top 5 hot leads. See references/example-output.md.

Step 5 — Offer follow-ups

"Want me to also: (a) launch a LinkedIn campaign for the qualified leads via launch-linkedin-campaign, or (b) personalize messages for the top N via personalize-message?"

Don't run anything unless the user says yes.

Failure surfacing — verbatim, never summarised

When leads:qualify exits non-zero, paste its stderr unchanged. The CLI's messages are tested and stable.

Notes

  • Pipeline writes to ~/.gtm-os/gtm-os.db. Side-effecting → Pattern A (shell-out) per the architecture doc.
  • 7 gates: dedup → prequal → exclusion → company-fit → role-fit → ICP scoring → optional signal enrichment. See src/lib/qualification/pipeline.ts.
  • --enrich-signals ≈ 1 PredictLeads credit per surviving domain (cached 7 days).

© Othmane-Khadri, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file (references) in .claude/skills/qualify-leads of Othmane-Khadri/YALC-the-GTM-operating-system.

  • SKILL.md
  • references/example-output.md

Open the folder on GitHubat commit 5686d1f

Compare with similar skills

Qualify Leads next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Qualify Leads compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Qualify Leads this skillOthmane-Khadri/YALC-the-GTM-operating-system317—~1.4kAutomated safety check: NotesMIT
Marketing PlanNexus-JPF/note-companion8705 repos~5.2kAutomated safety check: PassMIT
B2b Brand Marketingarnabbagxd/Brand-building-skills724—~2.4kAutomated safety check: PassMIT
Gtm FoundationsGTM-Strategist/gtm-strategist-skills263—~5.9kAutomated safety check: PassMIT
Gtm Motionsphuryn/pm-skills27k—~1.9kAutomated safety check: PassMIT
Running MarketingGTM-Strategist/gtm-strategist-skills263—~7.8kAutomated safety check: PassMIT

Similar skills

  • Marketing Plan

    Nexus-JPF/note-companion

    When the user needs a comprehensive marketing plan for a client, a company they advise, or their own product.

    870 GitHub starsUsed in 5 repos~5.2k tokens
    Marketing & SEOAuto-check passed
  • B2b Brand Marketing

    arnabbagxd/Brand-building-skills

    Build and execute brand marketing strategy for B2B companies — thought leadership, ABM brand layer, trust signals, LinkedIn presence, long sales cycle brand touchpoints, and enterprise credibility.

    724 GitHub stars~2.4k tokensUpdated 3 mo ago
    Marketing & SEOAuto-check passed
  • Gtm Foundations

    GTM-Strategist/gtm-strategist-skills

    A skill your agent uses when the user wants to start their go-to-market strategy, build a strategic foundation, or asks about SWOT analysis, value proposition canvas, 90-day GTM plan, analytics…

    263 GitHub stars~5.9k tokensUpdated 2 mo ago
    Marketing & SEOAuto-check passed
  • Gtm Motions

    phuryn/pm-skills

    Identify the best GTM motions and tools across 7 motion types: Inbound, Outbound, Paid Digital, Community, Partners, ABM, and PLG.

    27k GitHub stars~1.9k tokensUpdated 25 days ago
    Marketing & SEOAuto-check passed
  • Running Marketing

    GTM-Strategist/gtm-strategist-skills

    A skill your agent uses when the user wants to build an ongoing marketing engine, create a content strategy, set up social media publishing, plan influencer partnerships, or run email and paid ad…

    263 GitHub stars~7.8k tokensUpdated 2 mo ago
    Marketing & SEOAuto-check passed
  • Gtm Alignment

    WellApp-ai/Well

    Align phases with GTM strategy, persona tiers, and KPI targets

    345 GitHub stars~1.6k tokensUpdated 2 days ago
    Marketing & SEOAuto-check passed

More from Othmane-Khadri/YALC-the-GTM-operating-system

All 57 skills in this repo
  • Claap Weekly Recap

    Othmane-Khadri/YALC-the-GTM-operating-system

    Turns a week of Claap-recorded sales calls into action items and focus blocks on a Notion Kanban, delivered with a Slack summary.

    317 GitHub stars~5.4k tokensUpdated 1 mo ago
    Auto-check passed
  • Fullenrich Plg Reverse Lookup

    Othmane-Khadri/YALC-the-GTM-operating-system

    A skill your agent uses when the user says "set up FullEnrich reverse lookup for trial signups", "PLG enrichment webhook", "identify free trial signups via FullEnrich", "reverse email lookup for…

    317 GitHub stars~1.3k tokensUpdated 1 mo ago
    Auto-check passed
  • Fullenrich Content Engagers

    Othmane-Khadri/YALC-the-GTM-operating-system

    A skill your agent uses when the user says "enrich people who engaged with this post", "qualify post engagers with FullEnrich", "scrape and enrich LinkedIn post {URL}", "engagers from this post into…

    317 GitHub stars~1.5k tokensUpdated 1 mo ago
    Auto-check: warnings
  • Fullenrich Event Attendees

    Othmane-Khadri/YALC-the-GTM-operating-system

    A skill your agent uses when the user says "enrich this LinkedIn event", "enrich attendees of this event", "enrich this attendees CSV", "scrape and enrich LinkedIn event {URL}", "FullEnrich event…

    317 GitHub stars~1.4k tokensUpdated 1 mo ago
    Auto-check: warnings
  • Answer Linkedin Comments

    Othmane-Khadri/YALC-the-GTM-operating-system

    Reply to comments on a LinkedIn post via Unipile — drafts thread-aware replies grounded in the user's voice and the conversation context, then sends on approval.

    317 GitHub stars~551 tokensUpdated 1 mo ago
    Auto-check: notes
  • Fullenrich Network Activation

    Othmane-Khadri/YALC-the-GTM-operating-system

    A skill your agent uses when the user says "activate co-founder network with FullEnrich", "enrich LinkedIn connections export", "qualify my LinkedIn connections CSV", "turn Connections.csv into a…

    317 GitHub stars~1.1k tokensUpdated 1 mo ago
    Auto-check: warnings

Questions about Qualify Leads

What does Qualify Leads do?

Run the GTM-OS 7-gate qualification pipeline over a batch of leads from a CSV, JSON, Notion DB, profile-visitors export, post-engagers export, or an existing SQLite result set. Qualify Leads is an agent skill from Othmane-Khadri/YALC-the-GTM-operating-system. Run the GTM-OS 7-gate qualification pipeline over a batch of leads from a CSV, JSON, Notion DB, profile-visitors export, post-engagers export, or an existing SQLite result set.

When should I use Qualify Leads?

Qualify Leads fits situations like: the user says qualify these leads; score this lead list; run the qualification pipeline; check if these leads are a fit.

How do I install Qualify Leads in Claude Code?

Run `npx skills add Othmane-Khadri/YALC-the-GTM-operating-system --skill qualify-leads -a claude-code`. Or copy the skill folder (.claude/skills/qualify-leads in Othmane-Khadri/YALC-the-GTM-operating-system) into .claude/skills/qualify-leads in your project. Claude Code loads it when a task matches its description.

How do I install Qualify Leads in Codex?

Run `npx skills add Othmane-Khadri/YALC-the-GTM-operating-system --skill qualify-leads -a codex`. Or copy the skill folder (.claude/skills/qualify-leads in Othmane-Khadri/YALC-the-GTM-operating-system) into .agents/skills/qualify-leads in your project. Codex loads it when a task matches its description.

Can I use Qualify Leads in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Othmane-Khadri/YALC-the-GTM-operating-system --skill qualify-leads -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/qualify-leads, .gemini/skills/qualify-leads, .github/skills/qualify-leads and .opencode/skills/qualify-leads in your project.

What does Qualify Leads need to run?

Going by SKILL.md and its folder, Qualify Leads needs the command-line tools its instructions call (npx). Our summary lists: Node.js.

Does Qualify Leads access the network?

SKILL.md contains no URLs. Its commands use npx, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Qualify Leads safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Qualify Leads use?

Qualify Leads is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Qualify Leads use?

About 1.4k tokens (SKILL.md is roughly 5.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 469 tokens, read only when the agent opens those files.

What are the alternatives to Qualify Leads?

Skills that share tags, products or a category with Qualify Leads: Marketing Plan (Nexus-JPF/note-companion, 870 stars), B2b Brand Marketing (arnabbagxd/Brand-building-skills, 724 stars), Gtm Foundations (GTM-Strategist/gtm-strategist-skills, 263 stars) and Gtm Motions (phuryn/pm-skills, 27k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Qualify Leads?

Othmane-Khadri (a GitHub user) maintains it in Othmane-Khadri/YALC-the-GTM-operating-system, which has 317 GitHub stars. The repository holds 57 skills in this directory. The repository was last updated on August 20, 2026.

Source: Othmane-Khadri/YALC-the-GTM-operating-system on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.