skills/sales-proposal-template/SKILL.md
Designs reusable Qwilr proposal templates for your whole sales team. Use when every rep's proposals look different, reps waste hours building proposals from scratch, your templates are outdated and no one uses them, proposals lack consistent branding, or you need vertical-specific templates your whole team can reuse.
npx skillsauth add sales-skills/sales sales-proposal-templateInstall 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 design a system of reusable Qwilr templates that their whole sales team can use — with standardized structure, consistent branding, and token-ready fields for API/CRM auto-population.
If references/learnings.md exists, read it first for accumulated knowledge.
Ask the user:
What does your team sell?
How many distinct deal types do you have?
What's broken with proposals today?
How do you want reps to use these templates?
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.
Based on the context, design the template system:
Use the minimum number of templates that covers your deal types. A good rule of thumb:
| Scenario | Templates needed | |---|---| | One product, one buyer | 1 master template | | One product, SMB + Enterprise buyers | 2 templates (different depth/formality) | | Multiple products, same buyer | 1 template per product | | Multiple products + buyer segments | Matrix — but cap at 5-6 and use conditional sections |
Every template should have:
Fixed sections (same across all proposals):
Variable sections (customized per deal):
Conditionally included sections (used for some deals, not others):
For each template, provide a detailed blueprint:
Template name: [name] Use when: [which deal type this is for] Audience: [buyer persona]
| Section | Block Type | Fixed/Variable | Content notes |
|---|---|---|---|
| Cover | Splash | Variable | {{company_name}}, {{contact_name}}, custom headline |
| Executive Summary | Text | Variable | Rep writes this per deal — provide a fill-in-the-blank framework |
| Problem & Solution | Text | Semi-fixed | Template copy with {{industry}} and {{pain_point}} tokens |
| Scope of Work | Accordion | Variable | Rep customizes deliverables per deal |
| Pricing | Quote block | Variable | Pre-configured sections and line items, rep adjusts amounts |
| Case Study | Text + Image | Conditional | Library of 3-5 case studies, rep picks the most relevant |
| Timeline | Text | Semi-fixed | Standard phases with {{start_date}} token |
| About Us | Text + Image | Fixed | Same across all proposals |
| Team | Text + Image | Variable | Auto-populated with rep's info via {{rep_name}}, {{rep_photo}} |
| Next Steps | Accept block | Fixed | Standard acceptance flow |
For sections reps need to customize, provide fill-in-the-blank frameworks rather than leaving them blank:
Executive Summary framework:
[Company] is [one-line description of their situation]. Based on our conversations with [contact name] and the [team/department], the key priorities are:
- [Priority 1 — from discovery]
- [Priority 2 — from discovery]
- [Priority 3 — from discovery]
This proposal outlines how [your company] will address these priorities with [solution overview], delivering [primary expected outcome] within [timeframe].
Problem/Solution framework:
The challenge: [Industry] companies like [company] face [common challenge]. Specifically, [contact]'s team is dealing with [specific pain point from discovery].
Our approach: [Solution] addresses this by [how it works], which means [outcome in their terms].
Provide similar frameworks for each variable section.
Design the substitution tokens for API/CRM auto-population:
| Token | Source | Example |
|---|---|---|
| {{company_name}} | CRM: Company name | Acme Corp |
| {{contact_first_name}} | CRM: Contact first name | Jane |
| {{contact_last_name}} | CRM: Contact last name | Smith |
| {{contact_title}} | CRM: Contact title | VP Engineering |
| {{contact_email}} | CRM: Contact email | [email protected] |
| {{rep_name}} | CRM: Deal owner name | Alex Johnson |
| {{rep_title}} | CRM: Deal owner title | Account Executive |
| {{rep_email}} | CRM: Deal owner email | [email protected] |
| {{deal_amount}} | CRM: Deal amount | $48,000 |
| {{close_date}} | CRM: Expected close date | March 30, 2026 |
| Token | Source | Example |
|---|---|---|
| {{industry}} | CRM: Industry field | Financial Services |
| {{company_size}} | CRM: Employee count | 500 employees |
| {{product_name}} | CRM: Product field | Enterprise Plan |
| {{seat_count}} | CRM: Custom field | 25 seats |
| {{pain_point}} | Manual or CRM notes | Slow incident response times |
| {{start_date}} | CRM: Custom field | April 15, 2026 |
{{token}} text if a field is emptyRecommend supporting assets to create alongside templates:
/sales-proposal-analytics)/sales-qwilr-automation)Don't make templates too rigid. Templates should give reps a strong starting point, not a straitjacket. If reps can't easily customize the executive summary, scope, and pricing for their specific deal, they'll stop using the template. Use fill-in-the-blank frameworks, not fixed copy.
Don't forget variable placeholders. Every template should use {{token}} syntax for fields that will be auto-populated (company name, contact info, rep info, deal amount). Claude sometimes writes templates with hardcoded example values instead of tokens.
Don't design for one deal type when the team handles multiple. Ask how many distinct deal types exist before building templates. A single template for "SMB SaaS" and "Enterprise Financial Services" will serve neither well. But also don't over-segment — most teams need 2-4 templates, not 15.
Don't forget mobile responsiveness. Qwilr pages are web-based and will be viewed on phones and tablets. Avoid designs that depend on side-by-side layouts or wide tables that break on small screens. Test the template on mobile before rolling out.
Don't create templates without a rollout plan. A great template that reps don't know about or don't know how to use is wasted effort. Always include guidance on when to use each template and how to customize the variable sections.
Self-improving: If you discover something not covered here, append it to references/learnings.md with today's date.
/sales-proposal-page — Write a single proposal from scratch (not from template)/sales-qwilr-automation — Connect templates to CRM for auto-generation/sales-proposal-analytics — Track which templates get the best engagement/sales-deal-room — Design multi-page deal rooms (may need their own templates)/sales-content — General sales enablement content creation/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-dotools
Waitlister platform help — pre-launch waitlist platform with hosted landing pages, points-based viral referrals, built-in email broadcasts, REST API, and five HMAC-signed webhook events. Use when choosing Free (100 subscribers) vs Launch $15/mo (unlimited subs, referrals + broadcasts) vs Growth $49/mo (API, webhooks, Klaviyo/Mailchimp/Kit sync, fraud detection unlock here) vs Business $129/mo, building a webhook handler that verifies X-Webhook-Signature, webhooks auto-disabled after 10 consecutive failures, API signups bypassing referral fraud detection because client_ip/fingerprint weren't forwarded, granting bonus points or pulling top referrers via the API for reward fulfillment, broadcast send caps forcing an ESP handoff, automating without Zapier (Waitlister has none — webhooks/API only), or comparing Waitlister vs LaunchList/KickoffLabs/GetWaitlist/Prefinery. Do NOT use for list-growth strategy (use /sales-audience-growth) or LaunchList help (use /sales-launchlist).
development
LaunchList platform help — viral pre-launch waitlist platform with one-time lifetime pricing, gamified referrals (queue jumping, leaderboard, position inflation), embed widget + custom form POST endpoint, new_user/email_verify webhooks, Zapier, and spam protection. Use when choosing Free (100 submissions) vs Launch $29 (500) vs Grow $79 one-time (10K — webhooks, Zapier, team unlock here), wiring waitlist signups into Mailchimp/Kit/HubSpot or a CRM because LaunchList has no email broadcast system, needing programmatic access when there is no public REST API yet (form POST + webhook workaround), building a webhook handler with referred_by referral attribution, blocking disposable-email or bot signups on a viral waitlist, a custom signup form not submitting or not tracking referrals, or comparing LaunchList vs KickoffLabs/Viral Loops/Prefinery/GetWaitlist on one-time vs subscription pricing. Do NOT use for list-growth strategy (use /sales-audience-growth) or KickoffLabs help (use /sales-kickofflabs).
development
UpViral platform help — viral referral marketing and list-building platform (by Emarky) for viral sweepstakes, giveaway/reward campaigns, pre-launch waiting lists, and milestone referrals, with REST API (`app.upviral.com/api/v1/`, form-encoded `uvapikey` + `uvmethod`), Callback-URL webhooks, IP-based fraud detection, and 30+ ESP/CRM integrations. Use when campaigns aren't tracking referral points, deciding between Starter $79/mo (10K leads, NO API) vs Business $119/mo (API + webhooks) vs Premium $319/mo, the API erroring because you're on Starter where API/webhooks are gated, building a pipeline with `add_contact`/`get_leads`/`get_leads_points`, interpreting same-IP suspicious-referral flags, or picking UpViral over Viral Loops/Vyper/Gleam. Do NOT use for newsletter audience growth (use /sales-audience-growth), KickoffLabs help (use /sales-kickofflabs), merge-tag referrals (use /sales-referralkit), SparkLoop recommendations (use /sales-sparkloop), or multi-level Level 1/2/3 tracking (use /sales-referralhero).
tools
ReferralHero platform help — full-stack referral, affiliate, waitlist, contest, and NPS platform with REST API, webhooks, Zapier, native ESP connectors, multi-level referral tracking (Level 1/2/3), coupon groups, anti-fraud, and a 5,000 calls/hour limit. Use when referrals aren't tracking, deciding between Free (no API) vs PRO $199/mo (API + webhooks) vs PREMIUM $399/mo (ReCaptcha + SMS Verification), auth failing with `no_token` or `Bearer` vs `X-API-Key`, Level 2/3 counts off from calling `level_2_all_referrals` not `level_2_referrals`, bulk 429s from not chunking the 500-transaction `add_bulk_transactions` limit, coupon endpoints 404 without a coupon group, reward fulfillment (`promote` then `unlock_promoted_reward`) failing, or comparing to SparkLoop/ReferralKit/GrowSurf. Do NOT use for newsletter audience growth (use /sales-audience-growth), merge-tag referrals (use /sales-referralkit), SparkLoop recommendations (use /sales-sparkloop), or affiliate strategy across tools (use /sales-affiliate-program).