Corey Haines
f86637eace
* feat: add prospecting skill + truelist integration New skill: skills/prospecting/ - SKILL.md (251 lines, well under 500 limit): branch picker for SaaS / B2B / Local SMB, shared 5-phase framework (ICP -> discovery -> qualify -> score -> output), compliance guardrails, tool selection quick-picks, output formats - references/saas-prospecting.md: tech stack signals, funding/hiring triggers, SaaS-specific sources and qualification - references/b2b-prospecting.md: industry/firmographic signals, trigger events, decision-maker mapping, B2B-specific sources - references/local-prospecting.md: 4-tier website status classification, browser-assisted research workflow (generalized from the local-client- prospector pattern), proximity scoring - references/data-sources.md: deep dives on Apollo, Clay, ZoomInfo, Clearbit, Hunter, Snov, Truelist, LinkedIn Sales Nav, BuiltWith, Crunchbase, RB2B, with sequencing recommendations across the three branches - references/compliance.md: CAN-SPAM, GDPR, CASL, platform ToS (LinkedIn, Google Maps, Apollo/ZI/Clearbit), anti-patterns, audit checklist - evals/evals.json: 6 evals (2 SaaS, 2 B2B, 1 Local SMB, 1 deliverability) New integration: - tools/integrations/truelist.md: email deliverability validation (Deliverable / Risky / Undeliverable / Unknown classification) Registry + marketplace wiring: - tools/REGISTRY.md: truelist row + new Email Verification category section - .claude-plugin/marketplace.json: bumped to 2.1.0, prospecting added to plugin description - VERSIONS.md: prospecting 1.0.0 + 2.1.0 changelog entry - README.md: skill table re-synced, prospecting added to ASCII flow under Sales & GTM column All 41 skills pass validation. sync-skills.js is idempotent. Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com> * feat(prospecting): add GitHub stargazers/forks/watchers as discovery channel Net-new in this commit: - tools/clis/github-prospects.js: zero-dep Node CLI with commands stargazers / forks / watchers / user / rate-limit. Pagination via Link header, optional --enrich for full profile data, --with-email / --with-company / --with-blog filters, --format csv|json output, --dry-run preview. Uses GITHUB_TOKEN for 5000/hr rate limit (vs 60/hr unauthenticated). - tools/integrations/github.md: integration guide covering auth, rate limits, endpoints, workflows for SaaS prospecting, compliance notes (public API, not scraping), CLI reference. Skill updates: - skills/prospecting/SKILL.md: added GitHub to the tool selection quick picks and to the tool integrations table. - skills/prospecting/references/saas-prospecting.md: added GitHub to Tier 3 buying signals plus a dedicated "GitHub prospecting pattern (when audience is developers)" subsection with end-to-end workflow. - skills/prospecting/references/data-sources.md: added GitHub deep-dive section between RB2B and Free fallbacks. Registry: - tools/REGISTRY.md: github row in Tool Index, new Developer Intent / GitHub category section. All 41 skills still pass validation. sync-skills.js still no-op. Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com> * refactor(prospecting): apply review suggestions CLI hardening + optimization: - github-prospects.js: encodeURIComponent on username path interpolation (defense in depth; GitHub usernames are restricted enough that this is safe in practice, but good hygiene). - github-prospects.js: refactored enrichUsers to filter inline and support --target N early termination. Previously, --with-email on a 1000-star repo would enrich all 1000 users before filtering down to the ~50 that match. Now you can pass --target 25 to stop as soon as 25 matches are found, saving API quota on restrictive filters. - github.md: documented the new --target flag. Reverse cross-references (so prospecting is discoverable from sibling skills): - cold-email: added prospecting as the natural upstream skill - customer-research: added "Translating customer research into an ICP for outbound" hand-off to prospecting - competitor-profiling: distinguished from prospecting ("this skill does deep research on specific accounts; prospecting builds the initial list") All 41 skills still pass validation. sync-skills.js still no-op. Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com> * fix(truelist): align integration doc with actual OpenAPI spec Source of truth: Truelist-Labs/truelist-openapi (OpenAPI 3.1). The earlier integration doc had inferred (and wrong) endpoint paths, request shapes, and status enum values. Corrected against the published spec: Base URL: https://api.truelist.io Endpoints (real): - POST /api/v1/verify_inline?email=... (sync single, email is query param) - POST /api/v1/verify (async bulk, body: {emails: [...]}) - GET /me (account info) Real email_state enum: - ok, email_invalid, risky, unknown, accept_all (not the inferred "Deliverable / Risky / Undeliverable / Unknown") Real email_sub_state enum: - email_ok, is_disposable, is_role, unknown_error, failed_smtp_check Also corrected: - Truelist has an official MCP server (Truelist-Labs/truelist-mcp) — was marked as MCP unavailable - Truelist has 7 official SDKs (Node, Python, Ruby, PHP, Go, Java, .NET) + framework integrations (Django, Laravel, Next.js, Rails, React, Svelte, Vue, WordPress) — was marked as SDK unavailable - Native integrations with Mailchimp, Klaviyo, HubSpot, Zapier, Make, n8n, Clay, Salesforce, ActiveCampaign, Brevo, ConvertKit, Drip, BigCommerce, Go High Level — was unlisted - Rate limits: 10 req/s per endpoint (was unspecified) Files updated: - tools/integrations/truelist.md: full rewrite against spec - tools/REGISTRY.md: MCP and SDK columns now show ✓ for truelist; classifier note in the Email Verification section reflects real enum values - skills/prospecting/evals/evals.json: eval #6 expected_output and assertions use real email_state values and mention the MCP server - skills/prospecting/references/data-sources.md: Truelist deep-dive uses real endpoint paths, real enum values, and lists the MCP/SDK ecosystem All 41 skills still pass validation. sync-skills.js still no-op. Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com> * feat(prospecting): add Firecrawl + Browserbase for single-target site research Both tools are programmatic scrapers, but their use in prospecting is strictly bounded: extract content from individual public business sites (the prospect's own website URL), never from the platforms hosting them (Google Maps, LinkedIn, Yelp, Apollo, etc.). This matches the line drawn by the original local-client-prospector reference skill and our own compliance section. New integration docs: - tools/integrations/firecrawl.md: REST + MCP + SDKs (Node/Python/Go/Rust); scrape / map / crawl / extract / search endpoints; explicit "when NOT to use" section listing the prohibited platforms. - tools/integrations/browserbase.md: real Chromium via Playwright/Puppeteer or Stagehand (AI-friendly natural-language extraction); session recordings; useful when rendering or interaction is required. Prospecting skill updates: - SKILL.md: added Firecrawl + Browserbase to tool selection quick picks and tool integrations table. - references/data-sources.md: new "Firecrawl / Browserbase (single-target site research)" section between RB2B and Free fallbacks. Includes the compliance line inline so the framing isn't lost. - references/local-prospecting.md: optional "programmatic verification" paragraph in the browser research workflow — once you have a candidate's URL from manual Maps discovery, you can hit it programmatically. - references/compliance.md: anti-pattern #1 now explicitly clarifies that Firecrawl/Browserbase are fine for the prospect's own website but not for the platforms hosting prospects. Registry: - tools/REGISTRY.md: firecrawl + browserbase rows in Tool Index, new "Site Scraping (single-target only)" category section with the compliance framing in the agent recommendation. All 41 skills still pass validation. sync-skills.js still no-op. Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com> --------- Co-authored-by: Claude Opus 4.7 <noreply@anthropic.com>
18 KiB
18 KiB
Marketing Skills for AI Agents
A collection of AI agent skills focused on marketing tasks. Built for technical marketers and founders who want AI coding agents to help with conversion optimization, copywriting, SEO, analytics, and growth engineering. Works with Claude Code, OpenAI Codex, Cursor, Windsurf, and any agent that supports the Agent Skills spec.
Built by Corey Haines. Need hands-on help? Check out Conversion Factory — Corey's agency for conversion optimization, landing pages, and growth strategy. Want to learn more about marketing? Subscribe to Swipe Files. Want an autonomous AI agent that uses these skills to be your CMO? Try Magister.
New to the terminal and coding agents? Check out the companion guide Coding for Marketers.
Contributions welcome! Found a way to improve a skill or have a new one to add? Open a PR.
Run into a problem or have a question? Open an issue — we're happy to help.
What are Skills?
Skills are markdown files that give AI agents specialized knowledge and workflows for specific tasks. When you add these to your project, your agent can recognize when you're working on a marketing task and apply the right frameworks and best practices.
How Skills Work Together
Skills reference each other and build on shared context. The product-marketing skill is the foundation — every other skill checks it first to understand your product, audience, and positioning before doing anything.
┌──────────────────────────────────────┐
│ product-marketing │
│ (read by all other skills first) │
└──────────────────┬───────────────────┘
│
┌──────────────┬─────────────┬─────────────┼─────────────┬──────────────┬──────────────┐
▼ ▼ ▼ ▼ ▼ ▼ ▼
┌──────────┐ ┌──────────┐ ┌──────────┐ ┌────────────┐ ┌──────────┐ ┌─────────────┐ ┌───────────┐
│ SEO & │ │ CRO │ │Content & │ │ Paid & │ │ Growth & │ │ Sales & │ │ Strategy │
│ Content │ │ │ │ Copy │ │Measurement │ │Retention │ │ GTM │ │ │
├──────────┤ ├──────────┤ ├──────────┤ ├────────────┤ ├──────────┤ ├─────────────┤ ├───────────┤
│seo-audit │ │cro │ │copywritng│ │ads │ │referrals │ │revops │ │mktg-ideas │
│ai-seo │ │signup │ │copy-edit │ │ad-creative │ │free-tools│ │sales-enable │ │mktg-psych │
│site-arch │ │onboarding│ │cold-email│ │ab-testing │ │churn- │ │launch │ │customer- │
│programm │ │popups │ │emails │ │analytics │ │ prevent │ │pricing │ │ research │
│schema │ │paywalls │ │social │ │ │ │community │ │competitors │ │ │
│content │ │ │ │video │ │ │ │lead-magnt│ │comp-profile │ │ │
│aso │ │ │ │image │ │ │ │co-mktg │ │directory │ │ │
│ │ │ │ │sms │ │ │ │ │ │prospecting │ │ │
└────┬─────┘ └────┬─────┘ └────┬─────┘ └─────┬──────┘ └────┬─────┘ └──────┬──────┘ └─────┬─────┘
│ │ │ │ │ │ │
└────────────┴─────┬──────┴──────────────┴─────────────┴──────────────┴──────────────┘
│
Skills cross-reference each other:
copywriting ↔ cro ↔ ab-testing
revops ↔ sales-enablement ↔ cold-email
seo-audit ↔ schema ↔ ai-seo
customer-research → copywriting, cro, competitors
See each skill's Related Skills section for the full dependency map.
Available Skills
| Skill | Description |
|---|---|
| ab-testing | When the user wants to plan, design, or implement an A/B test or experiment, or build a growth experimentation program.... |
| ad-creative | When the user wants to generate, iterate, or scale ad creative — headlines, descriptions, primary text, or full ad... |
| ads | When the user wants help with paid advertising campaigns on Google Ads, Meta (Facebook/Instagram), LinkedIn, Twitter/X,... |
| ai-seo | When the user wants to optimize content for AI search engines, get cited by LLMs, or appear in AI-generated answers.... |
| analytics | When the user wants to set up, improve, or audit analytics tracking and measurement. Also use when the user mentions... |
| aso | When the user wants to audit or optimize an App Store or Google Play listing. Also use when the user mentions 'ASO... |
| churn-prevention | When the user wants to reduce churn, build cancellation flows, set up save offers, recover failed payments, or... |
| co-marketing | When the user wants to find co-marketing partners, plan joint campaigns, or brainstorm partnership opportunities. Use... |
| cold-email | Write B2B cold emails and follow-up sequences that get replies. Use when the user wants to write cold outreach emails,... |
| community-marketing | Build and leverage online communities to drive product growth and brand loyalty. Use when the user wants to create a... |
| competitor-profiling | When the user wants to research, profile, or analyze competitors from their URLs. Also use when the user mentions... |
| competitors | When the user wants to create competitor comparison or alternative pages for SEO and sales enablement. Also use when... |
| content-strategy | When the user wants to plan a content strategy, decide what content to create, or figure out what topics to cover. Also... |
| copy-editing | When the user wants to edit, review, or improve existing marketing copy, or refresh outdated content. Also use when the... |
| copywriting | When the user wants to write, rewrite, or improve marketing copy for any page — including homepage, landing pages,... |
| cro | When the user wants to optimize, improve, or increase conversions on any marketing page or form — including homepage,... |
| customer-research | When the user wants to conduct, analyze, or synthesize customer research. Use when the user mentions "customer... |
| directory-submissions | When the user wants to submit their product to startup, SaaS, AI, agent, MCP, no-code, or review directories for... |
| emails | When the user wants to create or optimize an email sequence, drip campaign, automated email flow, or lifecycle email... |
| free-tools | When the user wants to plan, evaluate, or build a free tool for marketing purposes — lead generation, SEO value, or... |
| image | When the user wants to create, generate, edit, or optimize images for marketing — blog heroes, social graphics, product... |
| launch | When the user wants to plan a product launch, feature announcement, or release strategy. Also use when the user... |
| lead-magnets | When the user wants to create, plan, or optimize a lead magnet for email capture or lead generation. Also use when the... |
| marketing-ideas | When the user needs marketing ideas, inspiration, or strategies for their SaaS or software product. Also use when the... |
| marketing-psychology | When the user wants to apply psychological principles, mental models, or behavioral science to marketing. Also use when... |
| onboarding | When the user wants to optimize post-signup onboarding, user activation, first-run experience, or time-to-value. Also... |
| paywalls | When the user wants to create or optimize in-app paywalls, upgrade screens, upsell modals, or feature gates. Also use... |
| popups | When the user wants to create or optimize popups, modals, overlays, slide-ins, or banners for conversion purposes. Also... |
| pricing | When the user wants help with pricing decisions, packaging, or monetization strategy. Also use when the user mentions... |
| product-marketing | When the user wants to create or update their product marketing context document. Also use when the user mentions... |
| programmatic-seo | When the user wants to create SEO-driven pages at scale using templates and data. Also use when the user mentions... |
| prospecting | When the user wants to find, qualify, and build a list of prospects to reach out to — across B2B SaaS, general B2B, or... |
| referrals | When the user wants to create, optimize, or analyze a referral program, affiliate program, or word-of-mouth strategy.... |
| revops | When the user wants help with revenue operations, lead lifecycle management, or marketing-to-sales handoff processes.... |
| sales-enablement | When the user wants to create sales collateral, pitch decks, one-pagers, objection handling docs, or demo scripts. Also... |
| schema | When the user wants to add, fix, or optimize schema markup and structured data on their site. Also use when the user... |
| seo-audit | When the user wants to audit, review, or diagnose SEO issues on their site. Also use when the user mentions "SEO... |
| signup | When the user wants to optimize signup, registration, account creation, or trial activation flows. Also use when the... |
| site-architecture | When the user wants to plan, map, or restructure their website's page hierarchy, navigation, URL structure, or internal... |
| sms | When the user wants to plan, build, or optimize SMS or MMS marketing — including welcome flows, abandoned cart texts,... |
| social | When the user wants help creating, scheduling, or optimizing social media content for LinkedIn, Twitter/X, Instagram,... |
| video | When the user wants to create, generate, or produce video content using AI tools or programmatic frameworks. Also use... |
Installation
Option 1: CLI Install (Recommended)
Use npx skills to install skills directly:
# Install all skills
npx skills add coreyhaines31/marketingskills
# Install specific skills
npx skills add coreyhaines31/marketingskills --skill cro copywriting
# List available skills
npx skills add coreyhaines31/marketingskills --list
This automatically installs to your .agents/skills/ directory (and symlinks into .claude/skills/ for Claude Code compatibility).
Option 2: Claude Code Plugin
Install via Claude Code's built-in plugin system:
# Add the marketplace
/plugin marketplace add coreyhaines31/marketingskills
# Install all marketing skills
/plugin install marketing-skills
Option 3: Clone and Copy
Clone the entire repo and copy the skills folder:
git clone https://github.com/coreyhaines31/marketingskills.git
cp -r marketingskills/skills/* .agents/skills/
Option 4: Git Submodule
Add as a submodule for easy updates:
git submodule add https://github.com/coreyhaines31/marketingskills.git .agents/marketingskills
Then reference skills from .agents/marketingskills/skills/.
Option 5: Fork and Customize
- Fork this repository
- Customize skills for your specific needs
- Clone your fork into your projects
Option 6: SkillKit (Multi-Agent)
Use SkillKit to install skills across multiple AI agents (Claude Code, Cursor, Copilot, etc.):
# Install all skills
npx skillkit install coreyhaines31/marketingskills
# Install specific skills
npx skillkit install coreyhaines31/marketingskills --skill cro copywriting
# List available skills
npx skillkit install coreyhaines31/marketingskills --list
Upgrading from v1.x to v2.0
v2.0 renames 17 skills and consolidates page-cro + form-cro into a single cro skill. If you installed the v1.x skills, you'll have stale old-name folders in your install directory after upgrading — the new skills install alongside the old ones, so you'll see both skills/page-cro/ and skills/cro/, etc. Clean them up:
# From the directory where you installed the skills (e.g., .agents/skills/ or .claude/skills/)
rm -rf page-cro form-cro \
ab-test-setup analytics-tracking aso-audit competitor-alternatives \
email-sequence free-tool-strategy launch-strategy onboarding-cro \
paid-ads paywall-upgrade-cro popup-cro pricing-strategy \
product-marketing-context referral-program schema-markup \
signup-flow-cro social-content
Then reinstall the v2.0 skills via your usual method (e.g., npx skills add coreyhaines31/marketingskills).
Migrate the product marketing context file
In v2.0 the context file moved from .claude/ to .agents/ and was renamed from product-marketing-context.md to product-marketing.md. Move your existing context file:
mkdir -p .agents
# v2.0 file (or pre-v2.0 file with new name)
mv .claude/product-marketing.md .agents/product-marketing.md 2>/dev/null
# pre-v2.0 file with legacy name
mv .claude/product-marketing-context.md .agents/product-marketing.md 2>/dev/null
Skills will still check .claude/ and the legacy product-marketing-context.md filename as fallbacks, so nothing breaks if you don't migrate.
Full rename map
| Old | New |
|---|---|
ab-test-setup |
ab-testing |
analytics-tracking |
analytics |
aso-audit |
aso |
competitor-alternatives |
competitors |
email-sequence |
emails |
form-cro |
merged into cro |
free-tool-strategy |
free-tools |
launch-strategy |
launch |
onboarding-cro |
onboarding |
page-cro |
cro |
paid-ads |
ads |
paywall-upgrade-cro |
paywalls |
popup-cro |
popups |
pricing-strategy |
pricing |
product-marketing-context |
product-marketing |
referral-program |
referrals |
schema-markup |
schema |
signup-flow-cro |
signup |
social-content |
social |
Usage
Once installed, just ask your agent to help with marketing tasks:
"Help me optimize this landing page for conversions"
→ Uses cro skill
"Write homepage copy for my SaaS"
→ Uses copywriting skill
"Set up GA4 tracking for signups"
→ Uses analytics skill
"Create a 5-email welcome sequence"
→ Uses emails skill
You can also invoke skills directly:
/cro
/emails
/seo-audit
Skill Categories
Conversion Optimization
cro- Pages and formssignup- Registration flowsonboarding- Post-signup activationpopups- Modals and overlayspaywalls- In-app upgrade moments
Content & Copy
copywriting- Marketing page copycopy-editing- Edit and polish existing copycold-email- B2B cold outreach emails and sequencesemails- Automated email flowssocial- Social media contentimage- AI image generation, design tools, and optimization
SEO & Discovery
seo-audit- Technical and on-page SEOai-seo- AI search optimization (AEO, GEO, LLMO)programmatic-seo- Scaled page generationsite-architecture- Page hierarchy, navigation, URL structurecompetitors- Comparison and alternative pagesschema- Structured data
Paid & Distribution
ads- Google, Meta, LinkedIn ad campaignsad-creative- Bulk ad creative generation and iterationsocial- Social media scheduling and strategy
Measurement & Testing
analytics- Event tracking setupab-testing- Experiment design
Retention
churn-prevention- Cancel flows, save offers, dunning, payment recovery
Growth Engineering
co-marketing- Partner identification and joint campaignsfree-tools- Marketing tools and calculatorsreferrals- Referral and affiliate programs
Strategy & Monetization
marketing-ideas- 140 SaaS marketing ideasmarketing-psychology- Mental models and psychologylaunch- Product launches and announcementspricing- Pricing, packaging, and monetization
Sales & RevOps
revops- Lead lifecycle, scoring, routing, pipeline managementsales-enablement- Sales decks, one-pagers, objection docs, demo scripts
Contributing
Found a way to improve a skill? Have a new skill to suggest? PRs and issues welcome!
See CONTRIBUTING.md for guidelines on adding or improving skills.
License
MIT - Use these however you want.