conversation-summarization
Installation
SKILL.md
Conversation Summarization
You are an expert in building sales bots that create clear, actionable summaries of prospect conversations. Your goal is to help developers create systems that produce summaries useful for human handoff, CRM updates, and deal continuity.
Why Summarization Matters
The Handoff Problem
Without summarization:
Rep picks up conversation, asks:
"So tell me about your situation..."
Prospect: "I already explained this to your bot."
Result: Frustration, lost trust, wasted time
With Good Summarization
Rep picks up conversation, says:
"I see you're looking at [product] for your
15-person marketing team, and timeline is
important because of your Q2 campaign. Let
me pick up where we left off..."
Prospect: "Exactly. Yes, let's continue."
Result: Seamless experience, trust maintained
Summary Types
Handoff Summary
Purpose: Transfer to human rep
Audience: Sales rep taking over
Length: 2-4 paragraphs
Includes:
- Prospect context (who they are)
- What they need (pain/goals)
- Where conversation ended
- Recommended next steps
- Any concerns/objections raised
- Urgency level
CRM Update
Purpose: Record in CRM
Audience: Anyone viewing the contact
Length: 3-5 bullet points
Includes:
- Key facts learned
- Qualification status
- Next action required
- Important quotes
- Updated contact fields
Meeting Prep
Purpose: Brief before scheduled call
Audience: Rep preparing for meeting
Length: 1 page
Includes:
- Full conversation history summary
- All stated needs/pains
- Questions to ask
- Potential objections
- Suggested talking points
Internal Log
Purpose: Audit trail
Audience: Operations/compliance
Length: Detailed, timestamped
Includes:
- Complete interaction log
- Bot decision points
- System actions taken
- Compliance-relevant details
Summary Components
Prospect Profile
Extract and structure:
Contact:
- Name: Sarah Chen
- Title: VP of Marketing
- Company: TechCorp (500 employees, SaaS)
- Email: sarah@techcorp.com
- Phone: +1 415-555-1234
Context:
- Source: Inbound demo request
- First contact: Jan 15, 2024
- Total interactions: 3 emails, 1 SMS
Needs & Pain Points
What they said they need:
Explicit:
- "We need to reduce time spent on reporting"
- "Integration with Salesforce is a must"
Implied:
- Mentioned team is overwhelmed → capacity issue
- Asked about ROI → needs to justify budget
- Mentioned boss → not sole decision maker
Prioritized:
1. Time savings (mentioned 3x)
2. Integration (mentioned as "must have")
3. Ease of use (asked about training)
Qualification Data
BANT/MEDDIC data captured:
Budget:
- Range: $20-30k annually
- Source: "We have budget allocated"
Authority:
- Champion: Sarah (VP Marketing)
- Economic Buyer: CMO (mentioned)
- Decision process: "I recommend, CMO approves"
Need:
- Primary: Reporting automation
- Secondary: Campaign tracking
Timeline:
- Target: Q2 implementation
- Driver: "New fiscal year planning"
Conversation Flow
Key exchanges summarized:
1. Initial inquiry (Jan 15):
Prospect asked about reporting features.
Bot provided overview, offered demo.
2. Follow-up (Jan 17):
Prospect asked about pricing tiers.
Bot explained options, asked about team size.
Prospect: "15 people in marketing."
3. Demo scheduling (Jan 18):
Prospect agreed to demo.
Scheduled for Jan 22, 2pm PT.
Requested Salesforce integration focus.
Objections & Concerns
Issues raised:
Concern: "We tried something similar before."
Context: Previous tool was hard to implement.
Status: Acknowledged, not resolved.
Recommended response: Address implementation ease.
Concern: "Price seems high for our size."
Context: Comparing to lower-tier competitors.
Status: Bot offered to discuss value/ROI.
Recommended response: ROI calculator, case study.
Action Items
What needs to happen:
Immediate:
□ Demo scheduled Jan 22, 2pm PT
□ Send Salesforce integration docs
□ Assign to Enterprise AE (deal size)
Before demo:
□ Research TechCorp's current tools
□ Prepare ROI model for their size
□ Find similar customer case study
Post-demo:
□ Send proposal if positive
□ Schedule follow-up with CMO
Summary Generation
Template Approach
def generate_handoff_summary(conversation):
return f"""
## Handoff Summary
### Prospect
{format_prospect_profile(conversation.prospect)}
### Situation
{summarize_needs(conversation)}
### Conversation History
{summarize_key_exchanges(conversation)}
### Qualification
{format_qualification_data(conversation)}
### Open Items
{list_concerns_objections(conversation)}
### Recommended Next Steps
{suggest_next_actions(conversation)}
### Notable Quotes
{extract_key_quotes(conversation)}
"""
AI Summarization
def ai_summarize(conversation, summary_type):
prompt = f"""
Summarize this sales conversation for {summary_type}.
Conversation:
{conversation.full_transcript}
Extract:
1. Who is the prospect (name, title, company)
2. What do they need (stated and implied)
3. Key qualification info (budget, timeline, authority)
4. Any concerns or objections raised
5. Where did the conversation end
6. Recommended next steps
Format as a structured summary a sales rep can
quickly scan before taking over.
"""
return llm.generate(prompt)
Hybrid Approach
Best results: Structured extraction + AI synthesis
Step 1: Extract structured data
- Contact info → structured fields
- Qualification → BANT fields
- Dates/times → parsed timestamps
Step 2: AI summarize unstructured
- Conversation flow narrative
- Nuanced needs interpretation
- Tone/sentiment assessment
Step 3: Combine
- Structured data in templates
- AI narrative in summary sections
- Human-readable final output
Format Examples
Slack/Teams Handoff
🔔 Hot Lead Handoff: Sarah Chen @ TechCorp
**Quick Context:**
VP Marketing at 500-person SaaS company. Inbound demo
request. Looking for reporting automation, must have
Salesforce integration.
**Qualification:**
✅ Budget: $20-30k approved
✅ Timeline: Q2 implementation
⚠️ Authority: Needs CMO sign-off
**Where We Left Off:**
Demo scheduled Jan 22, 2pm PT. Requested focus on
Salesforce integration. Previous tool failed on
implementation—address this.
**Next Step:**
Join demo, prepared with:
- Salesforce integration walkthrough
- ROI calc for 15-person team
- Implementation timeline
CRM Note
CONVERSATION SUMMARY - Jan 18, 2024
Contact: Sarah Chen, VP Marketing
Company: TechCorp (500 emp, SaaS)
Key Points:
• Looking for reporting automation
• 15-person marketing team
• Budget: $20-30k range
• Timeline: Q2 implementation
• Must have: Salesforce integration
• Concern: Previous tool was hard to implement
Next Step: Demo Jan 22, 2pm PT
Assigned: Enterprise AE Team
Priority: High (hot inbound)
Quote: "We need something that actually works with
Salesforce—last tool was a nightmare to integrate."
Email to Rep
Subject: Handoff: Sarah Chen @ TechCorp - Demo Tomorrow
Hi [Rep],
Handing off Sarah Chen from TechCorp for your demo
tomorrow at 2pm PT.
**The Situation:**
Sarah (VP Marketing) reached out asking about our
reporting automation. She leads a 15-person team and
is frustrated with manual reporting. They tried a
competitor before that "was a nightmare to integrate
with Salesforce"—so integration is her #1 priority.
**The Opportunity:**
- Budget allocated ($20-30k range)
- Q2 implementation target
- She recommends, CMO approves
- Hot inbound lead, moving quickly
**For Your Demo:**
- Focus heavily on Salesforce integration
- Show how easy implementation is
- Prepare ROI calc for 15-person team
- Have marketing-specific case study ready
**Watch Out For:**
She mentioned past bad experience, so she'll be
skeptical of implementation promises. Be specific
about timeline and support.
Good luck!
Quality Standards
Good Summary Characteristics
✓ Actionable: Reader knows what to do next
✓ Scannable: Key info jumps out quickly
✓ Complete: No critical info missing
✓ Accurate: Reflects what was actually said
✓ Contextualized: Includes relevant background
✓ Prioritized: Most important info first
Common Mistakes
✗ Too long: Burying key info in paragraphs
✗ Too short: Missing critical context
✗ Editorializing: Adding opinions not stated
✗ Jargon: Using internal terms prospect won't know
✗ No next step: Leaving reader unclear on action
✗ Stale: Not updated with latest interaction
Accuracy Checks
def validate_summary(summary, conversation):
issues = []
# Check for hallucinations
for fact in summary.extracted_facts:
if not fact_in_conversation(fact, conversation):
issues.append(f"Fact not found: {fact}")
# Check for missing critical info
if not summary.has_next_step:
issues.append("Missing next step")
if not summary.has_prospect_name:
issues.append("Missing prospect name")
# Check recency
if summary.generated_at < conversation.last_message_at:
issues.append("Summary outdated")
return issues
Automation & Integration
Auto-Generation Triggers
When to generate summary:
1. Handoff requested
→ Generate handoff summary
→ Notify assigned rep
2. Meeting scheduled
→ Generate meeting prep
→ Send to rep 1 hour before
3. Conversation ends
→ Generate CRM update
→ Push to CRM automatically
4. Daily rollup
→ Summarize all active conversations
→ Send to manager
CRM Integration
Push to CRM automatically:
Salesforce:
- Create/update Contact record
- Add to Activity History
- Update Lead Score
- Set Next Step date
HubSpot:
- Update Contact properties
- Add Timeline entry
- Update Deal stage
- Create Task for follow-up
Generic:
- API call with structured data
- Field mapping configuration
- Error handling/retry
Real-Time Updates
As conversation progresses:
After each exchange:
→ Update qualification fields
→ Append to conversation log
→ Recalculate priority score
On key events:
→ Meeting booked: Update next step
→ Objection raised: Flag for review
→ Buying signal: Alert rep
Summary stays current, not snapshot.
Privacy & Compliance
Data Handling
Summary may contain sensitive data:
Include:
- Business context
- Stated needs
- Timeline/budget ranges
Redact/mask:
- Credit card numbers
- Social security numbers
- Health information
- Passwords (if mistakenly shared)
Comply with:
- GDPR (right to access, deletion)
- CCPA (disclosure requirements)
- Industry regulations
Retention
How long to keep summaries:
Active deal: Indefinitely (until closed)
Closed won: Per company policy (usually 7 years)
Closed lost: Per policy (usually 2-3 years)
Prospect opted out: Delete per regulations
Implement:
- Automated retention policies
- Deletion workflows
- Audit logging
Measuring Quality
Summary Usefulness Metrics
Track:
- Rep feedback ratings
- Time-to-read (are they too long?)
- Edits made by reps (missing info?)
- Conversion rates with vs without summaries
Survey reps:
- Was the summary accurate?
- Was anything missing?
- Did it help you prepare?
- Suggestions for improvement?
Continuous Improvement
Feedback loop:
1. Generate summary
2. Rep uses summary
3. Rep provides feedback
4. Update summary templates
5. Retrain AI models
6. Repeat
Goal: Summaries that reps love and trust.
Weekly Installs
6
Repository
louisblythe/salesskillsGitHub Stars
11
First Seen
Mar 18, 2026
Security Audits