New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

List Architect

by swan-gtm in swan-gtm/gtm-skills

A skill your agent uses when building B2B lead lists — ICP definition and scoring, sourcing companies, qualifying accounts, finding contacts, persona mapping, deduplication, and data validation.

MITAuto-check passedMarketing & SEO

Install List Architect

skills CLI
$ npx skills add swan-gtm/gtm-skills --skill list-architect -a claude-code

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

GitHub CLI
$ gh skill install swan-gtm/gtm-skills list-architect --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/swan-gtm/gtm-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/alex-vacca/list-architect .claude/skills/list-architect && 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
list-architect
GitHub stars
172
Token cost
~1.7k tokens
SKILL.md length
567 words
Files
20 (incl. references)
Skills in repo
32
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when building B2B lead lists — ICP definition and scoring, sourcing companies, qualifying accounts, finding contacts, persona mapping, deduplication, and data validation.

  • Works in 5 steps: Identify which sub-skill(s) the user needs → If full workflow requested, present the… → Always clarify ICP if not provided… → …
  • Building B2B lead lists — ICP definition and scoring
  • SKILL.md covers Sub-Skill Routing, Decision Flow, Full Workflow Template and Reference Files, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

List Architect is an agent skill from swan-gtm/gtm-skills. Use this skill when building B2B lead lists — ICP definition and scoring, sourcing companies, qualifying accounts, finding contacts, persona mapping, deduplication, and data validation. Triggers on 'lead list', 'list building', 'Sales Navigator', 'boolean search', 'ICP', 'ideal customer profile', 'find leads', 'prospect list', 'email verification', 'list hygiene', 'build a list', 'find prospects', 'deduplicate', 'qualify accounts', 'ABM'.

Its SKILL.md is about 1.7k tokens, which your agent loads only when the skill is triggered. The skill folder holds 20 other files, including reference files (for example `references/account-selection-framework.md`, `references/account-selection.md` and `references/beginner-workflow.md`).

It sits in Marketing & SEO, covering Data cleaning, Positioning and messaging and Lead generation. The repository describes itself as: Open, production-grade GTM skills for AI agents. The licence is MIT.

When your agent uses it

  • Building B2B lead lists — ICP definition and scoring
  • Sourcing companies
  • Qualifying accounts
  • Finding contacts

Example prompts

  • “lead list”
  • “list building”
  • “Sales Navigator”
  • “/list-architect”

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Identify which sub-skill(s) the user needs
  2. If full workflow requested, present the beginner template first, then offer to deep-dive into any step
  3. Always clarify ICP if not provided (industry, company size, titles, geo, tech stack)
  4. Provide specific, actionable steps with tool recommendations
  5. Include relevant numbers (list size estimates, cost expectations, timeline)

What it can do on your machine

Read from SKILL.md and the folder at commit 67abd04. 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

    No scripts in the folder and no shell commands in SKILL.md.

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

  • Network

    Links to these hosts (documentation or services it may open):

    • frontal.so

    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

List Architect loads about 1.7k tokens when it runs, and up to ~33k if it reads all its reference files. Until then it costs about 114 tokens; SKILL.md has 567 words of instructions outside code blocks.

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

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 passed

The automated check found no risky patterns in SKILL.md.

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 swan-gtm/gtm-skills at commit 67abd04, republished under its MIT licence (© swan-gtm). 567 words, ~1,726 tokens.

Download SKILL.mdSave it as .claude/skills/list-architect/SKILL.md (or your agent's skills folder). This skill also uses 19 other files; get the full folder from GitHub.
name
list-architect
description
Use this skill when building B2B lead lists — ICP definition and scoring, sourcing companies, qualifying accounts, finding contacts, persona mapping, deduplication, and data validation. Triggers on 'lead list', 'list building', 'Sales Navigator', 'boolean search', 'ICP', 'ideal customer profile', 'find leads', 'prospect list', 'email verification', 'list hygiene', 'build a list', 'find prospects', 'deduplicate', 'qualify accounts', 'ABM'.
title
The list architect
category
Prospecting
contributors
ivan-falco

Reference files for this skill live in references/ next to this file — load them with the relative paths given below.

List Building — Master Orchestrator

You are an expert B2B list builder who has assembled prospect lists for campaigns sending 100K+ cold emails per month. You orchestrate 6 specialized sub-skills and route the user to the right one based on their question.

Sub-Skill Routing

Analyze the user's request and invoke the appropriate sub-skill:

User IntentSub-SkillTrigger PhrasesLoad
Define target audience, scoring criteriadefine-icp"ICP", "ideal customer profile", "who should I target", "scoring", "tier", "firmographic", "criteria"Read references/define-icp.md
Find target companies from data sourcessource-companies"find companies", "company list", "Apollo", "Google Maps", "HG Insights", "data sources", "where to find", "import companies"Read references/source-companies.md
Find contacts/people at companiesfind-contacts"find contacts", "find people", "boolean search", "Sales Navigator", "export leads", "Evaboot", "titles", "decision makers"Read references/find-contacts.md
Score and qualify individual accounts with ICP matrix, intent data layering, lookalikesqualify-accounts"qualify", "score accounts", "intent data", "lookalike", "prioritize accounts", "ICP scoring matrix"Read references/qualify-accounts.md
Verify emails/phones, manage bounce ratesclean-validate"verify", "validate", "bounce rate", "email verification", "ZeroBounce", "list hygiene", "data decay", "deliverability"Read references/clean-validate.md
Remove duplicates, merge data sourcesdeduplicate"deduplicate", "duplicates", "merge", "multiple sources", "clean up list", "data quality"Read references/deduplicate.md
ABM account selection, revenue reverse-engineering, how many accounts, account stagingaccount-selection"account selection", "ABM accounts", "target account list", "how many accounts", "ABM tier", "account staging", "revenue target", "ABM list"Read references/account-selection.md
Buying committee mapping, persona-based messagingpersona-mapping"persona mapping", "buying committee", "champion", "economic buyer", "persona", "JTBD", "who to target at account", "persona messaging"Read references/persona-mapping.md

Decision Flow

User Request
    |
    +-- Defining WHO to target? ---------> define-icp
    |
    +-- Finding COMPANIES? --------------> source-companies
    |
    +-- Finding PEOPLE/CONTACTS? --------> find-contacts
    |
    +-- Scoring/qualifying ACCOUNTS? ----> qualify-accounts
    |
    +-- Verifying/cleaning DATA? --------> clean-validate
    |
    +-- Removing DUPLICATES? ------------> deduplicate
    |
    +-- ABM account selection/sizing? ---> account-selection
    |
    +-- Buying committee/personas? ------> persona-mapping
    |
    +-- Full workflow / "build me a list"?
        |
        +-- Beginner? -> Read references/beginner-workflow.md
        |                 (7-step Clay workflow: Import -> Enrich -> Merge -> Validate -> Company Summary -> Check Fit -> Push)
        |
        +-- Advanced? -> Chain: define-icp -> source-companies -> find-contacts -> qualify-accounts -> clean-validate -> deduplicate
        |
        +-- ABM? -> Chain: account-selection -> persona-mapping -> source-companies -> find-contacts -> qualify-accounts -> clean-validate

Full Workflow Template

For users asking for a complete list building workflow, read the beginner workflow template:

  • File: Read references/beginner-workflow.md
  • Steps: Import Data -> Enrich Emails -> Merge Columns -> Validate -> Company Summary (GPT-4 mini) -> Check Fit (Claude) -> Push to Sequencer
  • Key principle: Cheap AI for scraping, smart AI for interpretation, conditional formulas everywhere
Show full SKILL.md (251 more words)Show less

Reference Files

Load the appropriate reference based on the sub-skill being invoked:

  • ICP, scoring, boolean search, Sales Nav filters, ABM -> Read references/sales-navigator-guide.md
  • Lead sources, Clay Find People, webhooks, import methods -> Read references/lead-sources-guide.md
  • Email/phone verification, bounce management, data decay, list hygiene -> Read references/data-validation.md
  • Step-by-step Clay pipeline, AI model selection, conditional formulas -> Read references/beginner-workflow.md
  • Qualification workflow: Frontal tier system, weighted scoring, Clay AI prompts, real examples, good list template -> Read references/qualification-workflow.md
Advanced List Building Resources
  • 62+ underused data sources by category -> Read references/list-building-data-sources.md
  • ICP deep-dives, multi-source workflows, Apollo+Clay template -> Read references/list-building-deep-dives.md
  • 100+ industry-specific directories for scraping -> Read references/list-building-directories.md
  • 8-phase quality list building framework -> Read references/list-building-framework.md
ABM Resources
  • Account selection framework, revenue reverse-engineering, staging -> Read references/account-selection-framework.md
  • Persona mapping, buying committee, messaging matrix -> Read references/persona-mapping-framework.md

Key Numbers to Remember

  • 2,500 — Sales Navigator max results per search (bypass by segmenting)
  • 22-30% — Annual email decay rate
  • <1% — Target bounce rate for campaigns
  • 95%+ — Target email deliverability
  • 100 points — ICP scoring system (Tier A: 90-100, B: 70-89, C: 50-69, D: <50)
  • 10-50 accounts — Tier 1 ABM (1:1 custom)
  • 30 days — Re-verify lists older than this

Response Format

  1. Identify which sub-skill(s) the user needs
  2. If full workflow requested, present the beginner template first, then offer to deep-dive into any step
  3. Always clarify ICP if not provided (industry, company size, titles, geo, tech stack)
  4. Provide specific, actionable steps with tool recommendations
  5. Include relevant numbers (list size estimates, cost expectations, timeline)

Part of Frontal — free, open GTM skills for your AI agent. Browse the library →

© swan-gtm, 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 19 other files (references) in skills/alex-vacca/list-architect of swan-gtm/gtm-skills.

  • SKILL.md
  • references/account-selection-framework.md
  • references/account-selection.md
  • references/beginner-workflow.md
  • references/clean-validate.md
  • references/data-validation.md
  • references/deduplicate.md
  • references/define-icp.md
  • references/find-contacts.md
  • references/lead-sources-guide.md
  • references/list-building-data-sources.md
  • references/list-building-deep-dives.md
  • references/list-building-directories.md
  • references/list-building-framework.md
  • references/persona-mapping-framework.md
  • references/persona-mapping.md
  • references/qualification-workflow.md
  • references/qualify-accounts.md
  • references/sales-navigator-guide.md
  • references/source-companies.md

Open the folder on GitHubat commit 67abd04

Compare with similar skills

List Architect 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.

List Architect compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
List Architect this skillswan-gtm/gtm-skills172—~1.7kAutomated safety check: PassMIT
LinkedIn Authority BuilderBrianRWagner/ai-marketing-claude-code-skills441—~1.9kAutomated safety check: PassNone
Cmo Advisorborghei/Claude-Skills891—~2.6kAutomated safety check: PassMIT
Chief Marketing Officercbrock84/headcount2k—~1.5kAutomated safety check: PassMIT
XurlLeoYeAI/openclaw-master-skills2.2k—~766Automated safety check: PassMIT
Google Maps API Skillbrowser-act/skills6.1k1 repos~1.4kAutomated safety check: PassMIT

Similar skills

  • LinkedIn Authority Builder

    BrianRWagner/ai-marketing-claude-code-skills

    Builds a LinkedIn thought-leadership content system, from positioning check and content pillars to formats and posting rhythm, in quick, standard or deep modes.

    441 GitHub stars~1.9k tokensUpdated 6 mo ago
    Marketing & SEOAuto-check passed

  • Cmo Advisor

    borghei/Claude-Skills

    Marketing leadership advisor on brand strategy, demand generation, and marketing operations.

    891 GitHub stars~2.6k tokensUpdated 3 days ago
    Marketing & SEOAuto-check passed

  • Chief Marketing Officer

    cbrock84/headcount

    Owns brand, demand generation, content, communications, and how the market understands what the business does.

    2k GitHub stars~1.5k tokensUpdated 23 days ago
    Marketing & SEOAuto-check passed

  • Xurl

    LeoYeAI/openclaw-master-skills

    A Twitter research and content intelligence skill focused on attracting WordPress and Shopify clients.

    2.2k GitHub stars~766 tokensUpdated 2 mo ago
    Marketing & SEOAuto-check passed

  • Google Maps API Skill

    browser-act/skills

    This skill helps users automatically scrape business data from Google Maps using the BrowserAct Google Maps API.

    6.1k GitHub starsUsed in 1 repo~1.4k tokens
    Marketing & SEOAuto-check passed

  • Competitive Cartographer

    curiositech/some_claude_skills

    Strategic analyst that maps competitive landscapes, identifies white space opportunities, and provides positioning recommendations.

    244 GitHub stars~1.3k tokensUpdated 1 mo ago
    Marketing & SEOAuto-check passed

More from swan-gtm/gtm-skills

All 32 skills in this repo

  • Revops Revenue Planning

    swan-gtm/gtm-skills

    Annual and quarterly revenue plan construction, top-down vs bottoms-up reconciliation, plan versioning, stretch goal handling, and FP&A-RevOps collaboration for B2B revenue teams.

    172 GitHub stars~7.2k tokensUpdated 3 days ago
    Auto-check passed

  • AI Personalization Prompts

    swan-gtm/gtm-skills

    A skill your agent uses when setting up AI-powered personalization, building Clay or lemlist workflows, or automating prospect research — 6 AI personalization prompts (lemlist style) plus 2 email…

    172 GitHub stars~653 tokensUpdated 3 days ago
    Auto-check passed

  • Audience Icp Filter

    swan-gtm/gtm-skills

    A skill your agent uses when a list of people already exists and someone needs to know who on it is worth contacting — event or webinar attendees, registrants, a prospecting export, a CRM segment, a…

    172 GitHub stars~1.9k tokensUpdated 3 days ago
    Auto-check passed

  • Brand Mention Monitor

    swan-gtm/gtm-skills

    A skill your agent uses when you need to know what people are saying about a brand across the web and social — "monitor brand mentions", "what are people saying about [brand] this week", "run a…

    172 GitHub stars~2.1k tokensUpdated 3 days ago
    Auto-check passed

  • Bridge Before Cold

    swan-gtm/gtm-skills

    Use this skill before staging a prospect and before drafting any first touch, when a segment has gone silent, and when deciding whether an account is genuinely cold.

    172 GitHub stars~1.4k tokensUpdated 3 days ago
    Auto-check passed

  • Champion Move Detection

    swan-gtm/gtm-skills

    Use this skill on a monthly cadence to detect champions and heavy users of your paying customers who changed jobs, verify the move against live LinkedIn data, score the new company, and surface…

    172 GitHub stars~5k tokensUpdated 3 days ago
    Auto-check passed

Categories

Questions about List Architect

What does List Architect do?

A skill your agent uses when building B2B lead lists — ICP definition and scoring, sourcing companies, qualifying accounts, finding contacts, persona mapping, deduplication, and data validation. List Architect is an agent skill from swan-gtm/gtm-skills. Use this skill when building B2B lead lists — ICP definition and scoring, sourcing companies, qualifying accounts, finding contacts, persona mapping, deduplication, and data validation.

When should I use List Architect?

List Architect fits situations like: building B2B lead lists — ICP definition and scoring; sourcing companies; qualifying accounts; finding contacts.

How do I install List Architect in Claude Code?

Run `npx skills add swan-gtm/gtm-skills --skill list-architect -a claude-code`. Or copy the skill folder (skills/alex-vacca/list-architect in swan-gtm/gtm-skills) into .claude/skills/list-architect in your project. Claude Code loads it when a task matches its description.

How do I install List Architect in Codex?

Run `npx skills add swan-gtm/gtm-skills --skill list-architect -a codex`. Or copy the skill folder (skills/alex-vacca/list-architect in swan-gtm/gtm-skills) into .agents/skills/list-architect in your project. Codex loads it when a task matches its description.

Can I use List Architect 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 swan-gtm/gtm-skills --skill list-architect -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/list-architect, .gemini/skills/list-architect, .github/skills/list-architect and .opencode/skills/list-architect in your project.

What does List Architect need to run?

SKILL.md names no scripts, command-line tools or credentials: List Architect is instructions for the agent only.

Does List Architect access the network?

SKILL.md names 1 domain. As links in the text: frontal.so. This is read from the text; nothing was executed.

Is List Architect safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does List Architect use?

List Architect 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 List Architect use?

About 1.7k tokens (SKILL.md is roughly 6.9k 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 31k tokens, read only when the agent opens those files.

What are the alternatives to List Architect?

Skills that share tags, products or a category with List Architect: LinkedIn Authority Builder (BrianRWagner/ai-marketing-claude-code-skills, 441 stars), Cmo Advisor (borghei/Claude-Skills, 891 stars), Chief Marketing Officer (cbrock84/headcount, 2k stars) and Xurl (LeoYeAI/openclaw-master-skills, 2.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains List Architect?

swan-gtm (a GitHub organization) maintains it in swan-gtm/gtm-skills, which has 172 GitHub stars. The repository holds 32 skills in this directory. The repository was last updated on October 8, 2026.

Source: swan-gtm/gtm-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.