skills/sales-forecast/SKILL.md
Builds and validate revenue forecasts with pipeline coverage and gap analysis. Use when you're not confident in your commit number, pipeline coverage looks thin, a forecast call is coming and you need to tighten the number, weighted pipeline doesn't match gut feel, or there's a gap between target and what's realistic. Do NOT use for individual deal analysis (use /sales-deal-inspect), portfolio pipeline management (use /sales-pipeline), or building outbound cadences (use /sales-cadence).
npx skillsauth add sales-skills/sales sales-forecastInstall 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 build and validate a revenue forecast — from category modeling through pipeline coverage analysis, deal-level inspection, and gap planning.
If references/learnings.md exists, read it first for accumulated knowledge.
Ask the user:
Scope:
Time period:
What numbers do you have? (provide what you know)
What's your primary concern?
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.
Build a forecast model table:
| Category | # Deals | Total Value | Win Probability | Weighted Value | |----------|---------|-------------|-----------------|----------------| | Closed Won | | | 100% | | | Commit | | | 85-95% | | | Best Case | | | 40-60% | | | Pipeline (Stage 3+) | | | 15-30% | | | Early Pipeline (Stage 1-2) | | | 5-10% | | | Upside (not in pipeline yet) | | | 2-5% | |
These are typical probability ranges — adjust based on the team's historical conversion data if available. Teams with strong qualification tend toward the higher end; teams early in building pipeline discipline should use the lower end.
| Metric | Value | |--------|-------| | Quota | | | Closed Won | | | Weighted forecast (sum of weighted values) | | | Expected outcome (most likely landing zone) | | | Gap to quota | | | Coverage ratio (total pipeline / remaining quota) | | | Commit coverage (commit / remaining quota) | |
Present as a range: "Based on current pipeline, expect to land between $X (worst) and $Y (best), most likely around $Z."
| Metric | Current | Benchmark | Status | |--------|---------|-----------|--------| | Coverage ratio (pipeline / quota) | | 3-4x for new business, 2-3x for expansion | Green/Yellow/Red | | Commit coverage (commit / remaining gap) | | 1.0x+ means commit covers the gap | | | Average deal size | | Compare to quota-required deal size | | | Average cycle length | | Deals must have enough runway to close in period | | | Win rate | | Historical vs. current period | | | Pipeline creation rate | | $ created per week/month — is it accelerating or slowing? | | | Stage conversion rates | | Stage 1→2, 2→3, 3→4, etc. — where are deals stalling? | |
For each deal in Commit and Best Case, create an inspection table:
| Deal | Value | Stage | Days in stage | Close date | Risk flags | Confidence | |------|-------|-------|--------------|------------|-----------|------------| | | | | | | | High/Med/Low |
For each deal, recommend one of:
If there's a gap between the forecast and quota, build a plan to close it:
| Lever | Description | Potential value | Actions | Timeline | |-------|-------------|----------------|---------|----------| | Pull-in | Accelerate deals currently slated for next period | | Identify 2-3 deals that could close sooner with the right push (executive meeting, POC, special terms) | This week | | Accelerate stalls | Reactivate stalled pipeline deals | | Re-engage with new value prop, bring in executive sponsor, offer assessment/workshop | 2 weeks | | Expansion | Upsell/cross-sell existing customers | | Identify customers with low product adoption, recent growth, or upcoming renewal | 2-4 weeks | | New outbound | Create new pipeline via outbound | | Blitz campaign to high-intent accounts, leverage trigger events (funding, hiring, tech changes) | 4-8 weeks | | Partner/referral | Source deals through partners or referrals | | Activate partner relationships, request customer referrals, co-sell with tech partners | 2-6 weeks |
For platform-specific forecasting guidance (Momentum, Sybill, Oliv, Outreach, Weflow, People.ai, Veloxy, Scratchpad, Dialpad), see references/platforms.md.
This skill covers a strategy domain across many platforms. Before pointing the user to any specific platform skill (any /sales-{platform} listed in ## Related skills, e.g., /sales-mailshake, /sales-klaviyo, /sales-apollo), read that platform skill's actual SKILL.md first. The 1-line description in ## Related skills is enough to identify a candidate — it's not enough to commit to it or to write a prompt that invokes it well.
How to read it:
~/.claude/skills/{skill-name}/SKILL.md exists locally, Read it.sales-* skills, WebFetch directly from this repo: https://raw.githubusercontent.com/sales-skills/sales/main/skills/{skill-name}/SKILL.md — e.g., for sales-mailshake: https://raw.githubusercontent.com/sales-skills/sales/main/skills/sales-mailshake/SKILL.md.sales-* skills (third-party), look up {org}/{repo} in ~/.claude/skills/sales-do/references/skill-sources.md if installed and fetch the same skills/{skill-name}/SKILL.md path under that repo.After reading, ground your recommendation in something concrete from the SKILL.md (its scope, a sub-flow, its argument-hint shape, or a "Do NOT use for..." negative trigger). Align any generated invocation with the platform skill's argument-hint. If the platform skill turns out not to fit the user's situation, swap to another or handle the question here directly rather than recommending a poor fit.
/sales-gong — Gong platform help (Gong Forecast module — widely considered weak, ~40% of customers stack Clari)/sales-salesloft — Salesloft Forecast module for submission workflows and AI-assisted predictions/sales-deal-inspect — Deep-dive on individual deals in your forecast/sales-pipeline — Portfolio-level pipeline management and deal prioritization/sales-cadence — Build outbound cadences for gap-plan pipeline generation/sales-close — Closing strategies for commit deals/sales-clari-copilot — Clari Copilot platform help — conversation intelligence tightly integrated with Clari's forecasting engine, deal scoring from call signals/sales-revenue-io — Revenue.io platform help — Revenue Intelligence dashboards and deal scoring for Salesforce-native teams/sales-momentum — Momentum platform help — AI revenue orchestration with automated CRM updates, MEDDIC Autopilot, AI coaching, churn signals, executive briefs (acquired by Salesforce Feb 2026)/sales-modjo — Modjo platform help — EU-native deal intelligence, Ask Modjo AI pipeline queries, CRM auto-fill for forecast accuracy, GDPR-compliant/sales-veloxy — Veloxy platform help — Salesforce-native field sales with predictive intelligence and automatic activity logging for better forecast data/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-doDon't use pipeline total without weighting by stage. Claude will sometimes say "you have $2M in pipeline against a $1M quota, so you're covered." Raw pipeline total is meaningless — only weighted pipeline matters. Always apply stage-based win probabilities.
Don't assume historical win rates apply to the current quarter. Win rates shift based on deal mix, market conditions, new competitors, and team changes. If the user provides historical rates, use them as a starting point but flag that current-quarter dynamics may differ.
Don't forget to account for slipped deals from last quarter. Deals that pushed from last quarter inflate current-quarter pipeline but often have lower close probability (they already missed one deadline). Flag these and weight them more conservatively.
Don't ignore seasonality. Q4 and fiscal year-end typically see higher close rates due to budget pressure. Q1 often sees longer cycles as budgets reset. Ask about the company's fiscal year when it matters.
Don't present a single forecast number without a range. Always give worst/most likely/best case scenarios. A single number creates false precision and sets the user up for a bad forecast call.
Self-improving: If you discover something not covered here, append it to references/learnings.md with today's date.
User says: "Build my team's Q2 forecast. Quota is $2M, we've closed $800k, commit is $600k across 4 deals, best case is $400k, total pipeline is $1.8M, 6 weeks left." Skill does:
User says: "Validate my $500k commit — Deal A ($200k, negotiation, strong champion), Deal B ($150k, proposal, no EB meeting), Deal C ($150k, demo stage, verbal interest only)." Skill does:
Solution: Start with what you know. The skill can build a useful forecast from just quota + closed-won + pipeline total. It will flag what's missing and estimate where possible. Even a rough forecast with assumptions stated is better than no forecast.
Solution: Apply stricter win probability weights. Most teams over-weight commit (use 85% not 95%) and best case (use 40% not 60%). Check for "commit creep" — deals that sit in commit for multiple forecast periods without closing. The deal-level inspection step catches these patterns.
Solution: Apply the 50% rule — at least half of gap plan value should come from pull-in and accelerate levers (fastest to materialize). New outbound takes 4-8 weeks to generate pipeline, so it won't help this quarter. Be conservative on each lever and plan for 1.5x the gap.
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.