skills/sales-smartlead/SKILL.md
Smartlead platform help — campaigns, SmartSenders, SmartInfra, SmartAgents, SmartDialer, SmartProspect, SmartDelivery, warmup, API, integrations, agency/white-label. Use when Smartlead emails are landing in spam, campaigns have low reply rates, SmartSenders mailboxes keep getting flagged, warmup scores aren't improving, SmartAgents aren't personalizing well, SmartDialer connect rates are low, SmartDelivery tests show poor inbox placement, agency workspaces need restructuring, or the Smartlead API isn't syncing. Do NOT use for building prospect lists (use /sales-prospect-list), designing cadence strategy (use /sales-cadence), cross-platform deliverability (use /sales-deliverability), or multi-client agency architecture (use /sales-agency-outbound).
npx skillsauth add sales-skills/sales sales-smartleadInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Help the user with Smartlead platform questions — from campaign setup and SmartSenders through SmartInfra, SmartAgents, SmartDialer, SmartProspect, SmartDelivery, agency/white-label, API, and integrations.
If references/learnings.md exists, read it first for accumulated knowledge.
Ask the user:
What area of Smartlead do you need help with?
/sales-cadence {your question})What's your role?
What are you trying to accomplish? (describe your specific goal or question)
If the user's request already provides most of this context, skip directly to the relevant step. Lead with your best-effort answer using reasonable assumptions (stated explicitly), then ask only the most critical 1-2 clarifying questions at the end — don't gate your response behind gathering complete context.
Note: If the user needs a specialized skill, route them there with a brief explanation of why that skill is a better fit.
If the request maps to a specialized skill, route:
/sales-prospect-list/sales-enrich/sales-cadence/sales-deliverability/sales-integration/sales-agency-outboundOtherwise, answer directly from platform knowledge using the reference below.
Provide module-by-module guidance based on the user's area:
Core entities — understand these to navigate the UI and work with the API:
| Entity | What it represents | Key relationships | |---|---|---| | Campaign | A multi-step email sequence | Has email steps, has Leads, uses Sender Accounts | | Lead | A contact enrolled in a campaign | Belongs to a Campaign, has activity tracking | | Sender Account | A connected email mailbox | Used by Campaigns, has warmup status | | Client/Workspace | A client account (agency) | Has Campaigns, has Sender Accounts | | SmartAgent | An AI research/personalization agent | Linked to Campaigns for content generation |
For detailed API documentation including all endpoints, authentication, rate limits, and webhook event payloads, always consult references/smartlead-api-reference.md. Point the user to this file for the full endpoint catalog, request/response schemas, and rate limit details.
Quick reference: Base URL https://server.smartlead.ai/api/v1/, API key auth (api_key query parameter). Key capabilities: campaign CRUD, lead management, sender account management, analytics, webhooks, client/workspace management (agency).
For broader integration architecture help beyond Smartlead's native connectors (e.g., building multi-tool workflows, Zapier/Make recipes, or webhook pipelines), use /sales-integration.
/sales-integration.Based on the user's specific question:
references/smartlead-api-reference.md."Don't skip SmartInfra evaluation for high-volume. Shared infrastructure has IP neighbor risk at scale. If you're sending 1,000+ emails/day or managing multiple clients, evaluate SmartInfra's dedicated IPs. One bad neighbor on a shared IP can tank your deliverability overnight.
Don't conflate Smartlead campaigns with Salesloft cadences. Smartlead campaigns are email-only by default. Phone steps require SmartDialer, and LinkedIn touchpoints need external tools. Don't promise multi-channel capabilities that require add-ons.
Don't use SmartAgents for simple merge-field personalization. SmartAgents are for research-grade personalization — finding company news, analyzing LinkedIn profiles, generating custom talking points. For simple {{first_name}} and {{company}} merge fields, just use standard campaign variables. SmartAgents add cost and latency for no benefit on simple personalization.
Don't assume Salesforce integration is native. Smartlead connects to Salesforce via OutboundSync, a paid third-party connector. It's not built-in like the HubSpot integration. Users need an OutboundSync subscription or can use Zapier as an alternative.
Don't skip warmup. Ultra Premium Warmup must run 2-3 weeks on new mailboxes before they're added to campaign rotation. Sending cold emails from unwarmmed mailboxes will land in spam. This applies even if the domain is established — new mailboxes need their own warmup.
Self-improving: If you discover something not covered here, append it to references/learnings.md with today's date.
/sales-cadence — Design outbound cadence strategy (platform-agnostic, works with Smartlead campaigns)/sales-deliverability — Cross-platform email deliverability — SPF/DKIM/DMARC, warmup, inbox placement/sales-prospect-list — Build prospect lists to import into Smartlead/sales-enrich — Enrich contacts with emails/phones before importing/sales-integration — Connect Smartlead to other tools via webhooks, Zapier, or API/sales-agency-outbound — Multi-client agency architecture — infrastructure, client isolation, onboarding/sales-mailshake — Mailshake platform help (if using Mailshake instead of Smartlead)/sales-apollo — Apollo.io platform help (if using Apollo instead of Smartlead)/sales-salesloft — Salesloft platform help (if using Salesloft instead of Smartlead)/sales-do — Not sure which skill to use? The router matches any sales objective to the right skill.User says: "How do I set up a new campaign in Smartlead with 10 mailboxes?" Skill does:
User says: "I need to set up 20 new mailboxes for outbound in Smartlead" Skill does:
User says: "I want to use the Smartlead API to add leads from our CRM to a campaign" Skill does:
references/smartlead-api-reference.md for full API docsPOST /campaigns/{id}/leads endpoint — email required, custom_fields for merge variablesLEAD_REPLIED and LEAD_INTERESTED to sync back to CRM
Result: User knows the endpoint, auth method, required fields, and how to build a bidirectional syncSymptom: Campaign open rates below 30%
Cause: Insufficient warmup, missing domain authentication, poor sender reputation, or weak subject lines
Solution: Check warmup status on all sender accounts — reputation should be 80+ before campaign sends. Verify SPF/DKIM/DMARC (SmartInfra auto-configures these, but verify in DNS). Run SmartDelivery inbox placement test. A/B test subject lines across variants. See /sales-deliverability for a full diagnosis framework.
Symptom: SmartAgent-generated content is generic or inaccurate Cause: Poorly configured prompts, insufficient data sources, or using SmartAgents for simple personalization Solution: Refine the SmartAgent prompt with specific instructions (what to research, what angles to find). Add more data sources (LinkedIn, company website, news). Review a sample of 10 outputs before launching at scale. If personalization needs are simple (name, company), skip SmartAgents and use standard merge fields.
Symptom: Sender reputation not increasing after 2+ weeks of warmup Cause: DNS misconfiguration, mailbox connectivity issues, or daily volume set too low Solution: Verify DNS records (SPF/DKIM/DMARC) are correct. Check mailbox connectivity — re-authenticate OAuth if needed. Ensure warmup daily volume is at least 20-30 emails. Check if the mailbox is also being used for non-warmup sends that could hurt reputation.
tools
UpViral platform help — viral referral marketing and list-building platform (by Emarky) for viral sweepstakes, giveaway/reward campaigns, pre-launch waiting lists, and milestone referral programs, with REST API (app.upviral.com/api/v1/), callback-URL webhooks, PHP SDK, fraud detection (IP-based suspicious-referral flagging), A/B testing, smart leaderboards, unlockable incentives, and 30+ native ESP/CRM integrations (Mailchimp, ActiveCampaign, ConvertKit, AWeber, HubSpot, Klaviyo, Intercom) plus Zapier/Make/Pipedream/Integrately/Pabbly. Use when UpViral campaigns aren't tracking referral points correctly, deciding between Starter $79/mo annual (10K leads, 1 brand, NO API) vs Business $119/mo (25K, 2 brands, API + webhooks unlocked) vs Premium $319/mo (100K, 5 brands, dedicated account manager), the API returns errors because you're on the Starter tier where API/webhooks are gated, building an UpViral→CRM or UpViral→data-warehouse pipeline with add_contact / get_leads / get_leads_points / add_points / get_custom_fields / lists methods (uvapikey + uvmethod form-encoded POST), interpreting fraud flags where same-IP referrals get marked suspicious and you must manually activate/delete/blacklist, setting up the Callback URL (webhook) to fire on reward-unlock events, Zapier New Lead / New Reward Unlocked triggers not firing, ClickFunnels/Shopify/funnel-builder integration breaking, the drag-and-drop page builder showing broken widgets or limited customization, the setup feeling long and complicated for your first campaign, or picking UpViral over Viral Loops / KickoffLabs / Vyper / Prefinery / Gleam / KingSumo / ShortStack for a viral campaign. Do NOT use for general newsletter audience growth strategy across all platforms (use /sales-audience-growth), newsletter monetization (use /sales-newsletter), KickoffLabs-specific help (use /sales-kickofflabs), no-code merge-tag newsletter referrals (use /sales-referralkit), SparkLoop paid recommendations (use /sales-sparkloop), or full-stack multi-level Level-1/2/3 referral/affiliate tracking (use /sales-referralhero).
development
ReferralHero platform help — full-stack referral, affiliate, waitlist, contest, and NPS platform with subscriber API, webhooks, Zapier, Mailchimp/Kit/AWeber/Klaviyo/ActiveCampaign/SendLane connectors, coupon codes, multi-level referral tracking (Level 1/2/3), anti-fraud, and 5,000 calls/hour rate limit. Use when ReferralHero campaigns aren't tracking referrals correctly, deciding between PRO $199/mo (10K members, includes API + webhooks) and PREMIUM $399/mo (50K members, adds ReCaptcha + SMS verification), authentication is failing with no_token or X-API-Key header is being ignored, multi-level referral counts (Level 2/3) aren't appearing for downline subscribers, coupon group endpoints return 404 or coupon arrays max out, hitting the 5,000 calls/hour soft limit and getting too_many_calls 429s, the Mailchimp/Kit native integration is double-adding subscribers, webhook payloads aren't firing on confirmation events, importing Stripe customer IDs through transaction tracking, generating reward fulfillment when subscribers cross milestone thresholds (promote/unlock_promoted_reward), comparing ReferralHero against SparkLoop/ReferralKit/Viral Loops/GrowSurf/KickoffLabs for referral marketing, or routing referral data via add_bulk_transactions (500-transaction batch limit). Do NOT use for general newsletter audience growth strategy (use /sales-audience-growth), general newsletter monetization (use /sales-newsletter), no-code newsletter-only referral with merge-tag insertion (use /sales-referralkit), SparkLoop's paid recommendations or partner network (use /sales-sparkloop), or affiliate program strategy across many platforms (use /sales-affiliate-program).
tools
KickoffLabs platform help — viral marketing platform for pre-launch waitlists, bonus-entry giveaways, milestone-reward referral programs, leaderboard giveaways, and email opt-in bribes with REST API v1 + v2, server-side webhooks (in/out), KOL.js JavaScript library, AnyForm script for custom pages, fraud detection (duplicate_ip / bounced / duplidate_email flags), SMS verification add-on, native ESP integrations (Klaviyo, Mailchimp, ActiveCampaign, Brevo), website builders (Webflow, Wix, Squarespace, Weebly), Shopify, Facebook Audiences, Slack, Zapier. Use when KickoffLabs viral campaigns aren't tracking referrals correctly, deciding between Hobby $13/mo annual (500 leads/mo no A/B no reward emails) vs Premium $48/mo (2.5K + A/B + reward emails + tracking pixels) vs Business $99/mo (10K + custom email templates + custom domains + advanced reporting + 3 team) vs Enterprise $202/mo (25K + 5 team + SMS included), API key getting rejected because you embedded it in client-side JavaScript instead of server-side, can't decide whether to use v1 /subscribe vs v2 /tags/:TAG_ID/lead for lead creation, webhook payloads firing with `__fraudulent` flag and you need to interpret the duplicate_ip/bounced/duplidate_email reason codes (yes, duplidate is spelled that way in their docs), AnyForm script not posting to KickoffLabs vs native API endpoint, leaderboard endpoint returning more than 50 leads is not allowed, social_id (kid in share URLs) attribution chain breaking between v1 and v2, contest score vs lead count metrics in the webhook payload are confusing, SMS Verification only available on Premium+ as $50/mo add-on (Enterprise includes), per-month lead cap auto-upgrades at $8 per 1000 overage leads, picking between KickoffLabs and Viral Loops / UpViral / Prefinery / ReferralCandy / Voucherify for viral campaign type fit, or rate limit per tier (10-100 calls/minute) is hitting on bulk imports. Do NOT use for general newsletter audience growth strategy (use /sales-audience-growth), general newsletter monetization (use /sales-newsletter), no-code merge-tag-only newsletter referrals (use /sales-referralkit), SparkLoop paid recommendations + partner network (use /sales-sparkloop), or full-stack referral/affiliate with multi-level Level-1/2/3 tracking (use /sales-referralhero).
development
Routes any sales, marketing, ad, or GTM objective to the right specialized skill and outputs the install command for that skill plus a ready-to-paste prompt packed with the user's context. Asks clarifying questions when the objective is ambiguous, then hands back a copy-paste-runnable next step. Covers prospecting, outbound cadences, deals, proposals, forecasting, deliverability, enrichment, intent, content, coaching, CRO, SEO, launch directories, newsletters, email/SMS/push marketing, chatbots, influencer marketing, social media, employee advocacy, media relations, reviews, data hygiene, B2B advertising, retargeting, affiliate, loyalty, digital products, memberships, webinars, checkout, and platform-specific help. Use when the user has a sales or marketing question and isn't sure which skill to use, or wants a multi-skill sequence with a batch install command. Do NOT use to solve problems directly — this skill only routes.