skills/sales-salesforce/SKILL.md
Salesforce platform help — Sales Cloud, Service Cloud, Marketing Cloud, Commerce Cloud, Data Cloud, Agentforce AI, Platform (Lightning/Apex/Flow), AppExchange, and REST API (v66.0, OAuth 2.0, SOQL, Bulk API 2.0). Use when Salesforce workflows or Flows aren't firing, reports don't show the right numbers, lead assignment rules aren't working, Apex triggers are failing, AppExchange app won't install, need help with SOQL queries, implementation is stalling, data migration to or from Salesforce, or not sure which Salesforce edition you need. Do NOT use for CRM comparison and selection (use /sales-crm-selection) or CRM data cleanup strategy (use /sales-data-hygiene).
npx skillsauth add sales-skills/sales sales-salesforceInstall 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.
If references/learnings.md exists, read it first for accumulated platform knowledge.
Ask the user:
What do you need help with?
Which edition are you on?
Team size?
Skip-ahead rule: if the user's prompt already provides enough context, skip to Step 2. Lead with your best-effort answer using reasonable assumptions (stated explicitly), then ask 1-2 critical clarifying questions.
| Problem domain | Route to |
|---|---|
| CRM comparison — Salesforce vs HubSpot vs Attio vs others | /sales-crm-selection {question} |
| Outbound sequence design across platforms | /sales-cadence {question} |
| CRM data cleanup, deduplication, record matching | /sales-data-hygiene {question} |
| Contact enrichment for CRM records | /sales-enrich {question} |
| Connecting Salesforce to other tools (architecture) | /sales-integration {question} |
| Lead scoring model design (cross-platform) | /sales-lead-score {question} |
| Lead routing and assignment strategy | /sales-lead-routing {question} |
| Revenue forecasting strategy | /sales-forecast {question} |
| Email deliverability for outbound | /sales-deliverability {question} |
When routing, provide the exact command.
Read references/platform-guide.md for the full platform reference — clouds, modules, pricing, integrations, data model, Flow Builder, Apex, SOQL.
Answer the user's question using only the relevant section. Don't dump the full reference.
If the question involves the REST API, also read references/salesforce-api-reference.md for endpoints, authentication, and rate limits.
You no longer need the platform guide — focus on the user's specific situation.
First-time setup priority: Create users and profiles → import accounts/contacts → set up opportunity pipeline stages → configure lead assignment rules → build 2-3 key Flows → connect email (Gmail/Outlook) → set up basic dashboards.
Edition selection shortcut: Starter for <10 users with basic CRM needs. Pro for forecasting and customization. Enterprise for API access, advanced automation, and multiple sandboxes. Unlimited for premier support and full AI. Most mid-market teams land on Enterprise.
When Salesforce is overkill: If you have <50 users, no dedicated admin, and don't need complex multi-department workflows, consider HubSpot or Attio first — use /sales-crm-selection to evaluate.
If you discover a gotcha, workaround, or tip not covered in references/learnings.md, append it there.
Best-effort from research — review these, especially plan-gated features and pricing which change frequently.
/sales-crm-selection — CRM comparison and selection — choosing between Salesforce, HubSpot, Attio, and others/sales-hubspot — HubSpot platform help — if considering HubSpot as an alternative/sales-data-hygiene — CRM data quality — deduplication, record matching, enrichment automation/sales-enrich — Contact enrichment — emails, phones, company data, bulk enrichment/sales-cadence — Outbound sequence design — multi-channel cadences across platforms/sales-integration — Connecting Salesforce to other tools — webhooks, Zapier, Make, MuleSoft/sales-lead-score — Lead scoring model design — dimensions, weights, MQL/SQL thresholds/sales-lead-routing — Lead routing and assignment — round-robin, territory, score-based/sales-forecast — Revenue forecasting — pipeline coverage, commit validation/sales-do — Not sure which skill to use? The router matches any sales objective to the right skill. Install: npx skills add sales-skills/sales --skill sales-doUser says: "We're a 30-person SaaS company evaluating Salesforce editions. We need API access and custom automation but don't want to overpay." Skill does: Reads platform guide for edition comparison. Recommends Enterprise ($175/user/mo) — it's the most popular tier because it includes API access, advanced Flow Builder, multiple sandboxes, and customization without the Unlimited premium. Flags that Starter/Pro lack full API access. Notes the implementation cost multiplier and recommends budgeting for a part-time admin. Result: User understands edition trade-offs and total cost of ownership.
User says: "I built a Flow to update opportunity stage when all tasks are completed, but it never fires." Skill does: Reads platform guide for Flow Builder section. Checks common causes: trigger type mismatch (record-triggered vs autolaunched), entry conditions too restrictive, flow not activated, running user lacks field-level security. Recommends using Debug mode in Flow Builder and checking Flow error emails in Setup. Notes that scheduled Flows have a 250K record limit per batch. Result: User identifies the root cause and gets the Flow working.
User says: "We've outgrown HubSpot — 80 users, complex deal cycles, need custom objects. How do we migrate to Salesforce?" Skill does: Validates that Salesforce is the right move at this scale (80 users, complex deals — yes). Walks through migration: map HubSpot objects → Salesforce objects (contacts, companies → accounts, deals → opportunities). Notes that HubSpot custom properties → Salesforce custom fields, but HubSpot workflows → Salesforce Flows require rebuilding. Recommends using HubSpot's native Salesforce integration for bi-directional sync during transition. Flags a 4-8 week timeline with consultant help. Result: User has a migration plan with timeline and gotchas.
Symptom: Dashboard metrics don't match what you see in list views or exports. Cause: Common causes: (1) report type filters exclude records (e.g., "Opportunities with Contact Roles" misses opportunities without contacts), (2) sharing rules restrict visibility — reports respect the running user's access, (3) cross-filters or date ranges set incorrectly, (4) archived records excluded by default. Solution: Check the report type — it determines which objects/fields are available. Verify the running user has visibility into the records. Check for cross-object filters. Use "Show Details" to see which records are included. For dashboard-level issues, check if the dashboard runs as a specific user or the viewing user.
Symptom: New leads go to the wrong owner or sit in a queue with no assignment.
Cause: Assignment rules evaluate top-to-bottom and stop at the first match. If the first rule is too broad, it catches everything. If no rule matches, the lead stays with the default owner. Web-to-Lead and API-created leads must have "Assign using active assignment rules" checked.
Solution: Review rule order in Setup → Lead Assignment Rules. Make specific rules first, broad catch-all rules last. Verify that the active rule set is the one you expect (only one can be active). For API/integration-created leads, pass the AssignmentRuleHeader in the API call.
Symptom: Pages load slowly, list views take 10+ seconds, reports time out. Cause: Usually a combination of: (1) too many fields on page layouts, (2) complex validation rules/triggers on record save, (3) list views with too many records and unindexed filters, (4) browser extensions interfering. Solution: Reduce visible fields on page layouts (show only what reps actually use). Check for Apex triggers that fire on every record save — inefficient triggers compound across the org. Use indexed fields in list view filters (standard fields, external IDs). Try incognito mode to rule out browser extensions. For reports, add filters to reduce the dataset before running.
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.