Sales skill

Transforms product documentation into sales-ready packages — a story explanation, charcoal gestural sketch art, and talking points — via a narrative-arc pipeline.

by danielmiessler·MIT license·★ 19,269 Stars on the repo·GitHub ↗

Use now

Files of Sales

danielmiessler/main1 file shown
SKILL.md
Show the full text161 lines

Customization

Before executing, check for user customizations at: ~/.claude/LIFEOS/USER/CUSTOMIZATIONS/SKILLS/Sales/

If this directory exists, load and apply any PREFERENCES.md, configurations, or resources found there. These override default behavior. If the directory does not exist, proceed with skill defaults.

🚨 MANDATORY: Voice Notification (REQUIRED BEFORE ANY ACTION)

You MUST send this notification BEFORE doing anything else when this skill is invoked.

  1. Send voice notification:

    curl -s -X POST http://localhost:31337/notify \
      -H "Content-Type: application/json" \
      -d '{"message": "Running the WORKFLOWNAME workflow in the Sales skill to ACTION"}' \
      > /dev/null 2>&1 &
    
  2. Output text notification:

    Running the **WorkflowName** workflow in the **Sales** skill to ACTION...
    

This is not optional. Execute this curl command immediately upon skill invocation.

Sales Skill

What It Does

Turns product documentation into a sales-ready package: a story narrative that captures the value proposition, a charcoal gestural sketch that conveys the concept visually, and clear talking points. It reads the real value out of technical docs and reframes it as something a sales team can actually use in a pitch.

The Problem

Product docs explain what a thing does. Sales needs to explain why it matters — and the gap between the two is where most pitches die. Hand a sales team a feature list and they read off bullet points; the buyer feels nothing and forgets it. The translation from "here's what it does" to "here's the story you'll remember" usually takes a writer and a designer and a few days, so it doesn't happen, and the product gets sold flat. This skill does that translation: it pulls the narrative arc out of the docs, finds the emotional register, and generates the narrative plus a matching visual tied directly to what's being sold.

How It Works

The pipeline runs in four steps, from raw docs to a finished package:

PRODUCT DOCUMENTATION
        ↓
[1] STORY EXPLANATION — Extract the narrative arc (what's the real value?)
        ↓
[2] EMOTIONAL REGISTER — What feeling should this evoke? (wonder, determination, hope, etc.)
        ↓
[3] VISUAL CONCEPT — Derive scene from narrative + emotion
        ↓
[4] GENERATE ASSETS — Create visual + narrative package
        ↓
SALES-READY OUTPUT

It produces three things: sales narratives (story explanations that capture the value proposition), visual assets (charcoal sketch art that conveys the concept), and scripts (clear, succinct messaging tied to what you're selling). Internally it leans on the story-explanation narrative engine and the Art essay-art workflow for the visual.


Workflow Routing

Workflow Trigger File
CreateSalesPackage Full sales package — "create a sales package", product docs in, narrative + charcoal sketch + key talking points out Workflows/CreateSalesPackage.md
CreateNarrative Sales narrative only — "turn this into a pitch", "create a sales story", technical docs to compelling narrative Workflows/CreateNarrative.md
CreateVisual Visual asset only — "create a visual for this sales story", charcoal sketch for an existing narrative Workflows/CreateVisual.md

Output Format

Sales Narrative
  • 8-24 point story explanation
  • First person, conversational
  • Captures the "why this matters" not just "what it does"
  • Ready for sales scripts, presentations, pitches
Visual Asset
  • Charcoal gestural sketch aesthetic
  • Minimalist composition with breathing space
  • Transparent background for versatility
  • Captures the emotional core of the value proposition

Example

Input: Technical documentation about AI code review tool

Output:

  • Narrative: "This tool doesn't just find bugs—it understands your codebase like a senior engineer who's been there for years. It catches the subtle issues that slip through PR reviews..."
  • Visual: Gestural sketch of human developer and AI figure collaborating, both examining the same code output
  • Talking Points:
    1. Senior engineer understanding, not just pattern matching
    2. Catches what humans miss in PR reviews
    3. Learns your specific codebase patterns

Integration

This skill combines:

  • A story-explanation skill - For narrative extraction
  • art skill (essay-art workflow) - For visual generation
  • Sales-specific framing - Value proposition focus

The goal: Sales teams get materials that are highly tied to what they're selling, clear, succinct, and effective.


Examples

Example 1: Full sales package from docs

User: "create a sales package for this product" [provides docs]
→ Extracts narrative arc using storyexplanation
→ Determines emotional register (wonder, determination, hope)
→ Generates charcoal sketch visual + narrative + talking points

Example 2: Sales narrative only

User: "turn this technical doc into a sales pitch"
→ Reads documentation and extracts value proposition
→ Creates 8-24 point story explanation in first person
→ Returns conversational narrative ready for sales scripts

Example 3: Visual asset for existing narrative

User: "create a visual for this sales story"
→ Analyzes narrative for emotional core
→ Derives scene concept from story + emotion
→ Generates charcoal gestural sketch with transparent background

Gotchas

  • Charcoal sketch art is the visual style for sales assets. Don't use other art styles unless explicitly asked.
  • Pitch decks must tell a STORY, not list features. Narrative arc matters more than bullet points.
  • NOT for Hormozi frameworks — use a dedicated Hormozi $100M Offers/Leads skill for that methodology.

Execution Log

After completing any workflow, append a single JSONL entry:

echo '{"ts":"'$(date -u +%Y-%m-%dT%H:%M:%SZ)'","skill":"Sales","workflow":"WORKFLOW_USED","input":"8_WORD_SUMMARY","status":"ok|error","duration_s":SECONDS}' >> ~/.claude/LIFEOS/MEMORY/SKILLS/execution.jsonl

Replace WORKFLOW_USED with the workflow executed, 8_WORD_SUMMARY with a brief input description, and SECONDS with approximate wall-clock time. Log status: "error" if the workflow failed.

1---
2name: Sales
3version: 1.0.28
4description: "Transforms product documentation into sales-ready packages — a story explanation, charcoal gestural sketch art, and talking points — via a narrative-arc pipeline. USE WHEN sales, proposal, pitch deck, value proposition, sales narrative, sales deck, sales package, turn this into a pitch, create a sales story, sales materials, product pitch, transform docs to sales, sales script. NOT FOR Hormozi $100M frameworks, value equation, irresistible offer, or VOC mining, standalone diagrams or illustrations (use Art), or platform social posts."
5---
6 
7## Customization
8 
9**Before executing, check for user customizations at:**
10`~/.claude/LIFEOS/USER/CUSTOMIZATIONS/SKILLS/Sales/`
11 
12If this directory exists, load and apply any PREFERENCES.md, configurations, or resources found there. These override default behavior. If the directory does not exist, proceed with skill defaults.
13 
14 
15## 🚨 MANDATORY: Voice Notification (REQUIRED BEFORE ANY ACTION)
16 
17**You MUST send this notification BEFORE doing anything else when this skill is invoked.**
18 
191. **Send voice notification**:
20 ```bash
21 curl -s -X POST http://localhost:31337/notify \
22 -H "Content-Type: application/json" \
23 -d '{"message": "Running the WORKFLOWNAME workflow in the Sales skill to ACTION"}' \
24 > /dev/null 2>&1 &
25 ```
26 
272. **Output text notification**:
28 ```
29 Running the **WorkflowName** workflow in the **Sales** skill to ACTION...
30 ```
31 
32**This is not optional. Execute this curl command immediately upon skill invocation.**
33 
34# Sales Skill
35 
36## What It Does
37 
38Turns product documentation into a sales-ready package: a story narrative that captures the value proposition, a charcoal gestural sketch that conveys the concept visually, and clear talking points. It reads the real value out of technical docs and reframes it as something a sales team can actually use in a pitch.
39 
40## The Problem
41 
42Product docs explain what a thing does. Sales needs to explain why it matters — and the gap between the two is where most pitches die. Hand a sales team a feature list and they read off bullet points; the buyer feels nothing and forgets it. The translation from "here's what it does" to "here's the story you'll remember" usually takes a writer and a designer and a few days, so it doesn't happen, and the product gets sold flat. This skill does that translation: it pulls the narrative arc out of the docs, finds the emotional register, and generates the narrative plus a matching visual tied directly to what's being sold.
43 
44## How It Works
45 
46The pipeline runs in four steps, from raw docs to a finished package:
47 
48```
49PRODUCT DOCUMENTATION
50 ↓
51[1] STORY EXPLANATION — Extract the narrative arc (what's the real value?)
52 ↓
53[2] EMOTIONAL REGISTER — What feeling should this evoke? (wonder, determination, hope, etc.)
54 ↓
55[3] VISUAL CONCEPT — Derive scene from narrative + emotion
56 ↓
57[4] GENERATE ASSETS — Create visual + narrative package
58 ↓
59SALES-READY OUTPUT
60```
61 
62It produces three things: sales narratives (story explanations that capture the value proposition), visual assets (charcoal sketch art that conveys the concept), and scripts (clear, succinct messaging tied to what you're selling). Internally it leans on the story-explanation narrative engine and the Art essay-art workflow for the visual.
63 
64---
65 
66 
67## Workflow Routing
68 
69| Workflow | Trigger | File |
70|----------|---------|------|
71| **CreateSalesPackage** | Full sales package — "create a sales package", product docs in, narrative + charcoal sketch + key talking points out | `Workflows/CreateSalesPackage.md` |
72| **CreateNarrative** | Sales narrative only — "turn this into a pitch", "create a sales story", technical docs to compelling narrative | `Workflows/CreateNarrative.md` |
73| **CreateVisual** | Visual asset only — "create a visual for this sales story", charcoal sketch for an existing narrative | `Workflows/CreateVisual.md` |
74 
75---
76 
77## Output Format
78 
79### Sales Narrative
80- 8-24 point story explanation
81- First person, conversational
82- Captures the "why this matters" not just "what it does"
83- Ready for sales scripts, presentations, pitches
84 
85### Visual Asset
86- Charcoal gestural sketch aesthetic
87- Minimalist composition with breathing space
88- Transparent background for versatility
89- Captures the emotional core of the value proposition
90 
91---
92 
93## Example
94 
95**Input:** Technical documentation about AI code review tool
96 
97**Output:**
98- **Narrative:** "This tool doesn't just find bugs—it understands your codebase like a senior engineer who's been there for years. It catches the subtle issues that slip through PR reviews..."
99- **Visual:** Gestural sketch of human developer and AI figure collaborating, both examining the same code output
100- **Talking Points:**
101 1. Senior engineer understanding, not just pattern matching
102 2. Catches what humans miss in PR reviews
103 3. Learns your specific codebase patterns
104 
105---
106 
107## Integration
108 
109This skill combines:
110- **A story-explanation skill** - For narrative extraction
111- **art skill (essay-art workflow)** - For visual generation
112- **Sales-specific framing** - Value proposition focus
113 
114---
115 
116**The goal:** Sales teams get materials that are highly tied to what they're selling, clear, succinct, and effective.
117 
118---
119 
120## Examples
121 
122**Example 1: Full sales package from docs**
123```
124User: "create a sales package for this product" [provides docs]
125→ Extracts narrative arc using storyexplanation
126→ Determines emotional register (wonder, determination, hope)
127→ Generates charcoal sketch visual + narrative + talking points
128```
129 
130**Example 2: Sales narrative only**
131```
132User: "turn this technical doc into a sales pitch"
133→ Reads documentation and extracts value proposition
134→ Creates 8-24 point story explanation in first person
135→ Returns conversational narrative ready for sales scripts
136```
137 
138**Example 3: Visual asset for existing narrative**
139```
140User: "create a visual for this sales story"
141→ Analyzes narrative for emotional core
142→ Derives scene concept from story + emotion
143→ Generates charcoal gestural sketch with transparent background
144```
145 
146## Gotchas
147 
148- **Charcoal sketch art is the visual style for sales assets.** Don't use other art styles unless explicitly asked.
149- **Pitch decks must tell a STORY, not list features.** Narrative arc matters more than bullet points.
150- **NOT for Hormozi frameworks** — use a dedicated Hormozi $100M Offers/Leads skill for that methodology.
151 
152## Execution Log
153 
154After completing any workflow, append a single JSONL entry:
155 
156```bash
157echo '{"ts":"'$(date -u +%Y-%m-%dT%H:%M:%SZ)'","skill":"Sales","workflow":"WORKFLOW_USED","input":"8_WORD_SUMMARY","status":"ok|error","duration_s":SECONDS}' >> ~/.claude/LIFEOS/MEMORY/SKILLS/execution.jsonl
158```
159 
160Replace `WORKFLOW_USED` with the workflow executed, `8_WORD_SUMMARY` with a brief input description, and `SECONDS` with approximate wall-clock time. Log `status: "error"` if the workflow failed.
161 

Discussion

Alternatives

AphorismsCurated aphorism collection with CRUD — content-based matching, themed search, thinker research, DB maintenance. Quotes organized by author/theme/context/usage to prevent repetition. Four workflows: FindAphorism, AddAphorism, ResearchThinker, SearchAphorisms. Themes: Stoicism, Wisdom, Truth-seeking, Excellence, Resilience, Curiosity. USE WHEN aphorism, quote, find a quote, research thinker, add aphorism, quote for newsletter, what did X say about, quote bank. NOT FOR creative writing or social posts.Sales & ecommerce · MITInfluence and negotiationInfluence and negotiation toolkit for any interaction needing another person's agreement, even when the user never says 'negotiation'. Covers B2B sales, salary reviews and raise asks, collective bargaining and unions, hard 1:1s, recruitment closes, cross-cultural deals, mediation, and diplomatic messages — declining, pushing back on scope, justifying a delay, raising a concern, getting alignment. Use when the user says 'they just said X, what do I say' or 'draft a reply', or mentions a buyer, champion, procurement, RFP, sponsor, HR, union, or candidate, or a pushback, refusal, ghosting, no-decision, escalation, fixed budget, counter-offer, comp band, strike, BATNA, anchor, or concession.Sales & ecommerce · MITSales materials that help you close dealsTell us what you sell and who buys it; get back a pitch outline, a one-page leave-behind, and ready answers to the objections you hear most.Business & ops · MITSales automatorSales automation and outreach specialist. Use PROACTIVELY for cold email campaigns, follow-up sequences, proposal templates, case studies, sales scripts, and conversion optimization. Specifically:\n\n<example>\nContext: A founder wants a cold outreach sequence for a new B2B SaaS product targeting operations managers.\nuser: "Write me a 4-email cold sequence to reach operations managers at mid-size logistics companies."\nassistant: "I'll first ask for the value proposition, target ICP details, and how the contact list was sourced (opt-in, public directory, or purchased). Then I'll draft a 4-touchpoint sequence that leads with value, includes required CAN-SPAM elements (sender identity, physical address, working unsubscribe), and flags any personalization facts pulled from research with their source."\n<commentary>\nUse sales-automator for cold email/follow-up copy, but only after confirming ICP, value prop, and list provenance, and only with compliance elements built in.\n</commentary>\n</example>\n\n<example>\nContext: A sales rep wants case studies to include in a proposal template.\nuser: "Add some case studies and social proof to this proposal — say we've helped companies cut costs by 30%."\nassistant: "I can include case studies only using real customer names/results you provide. If you don't have a confirmed example yet, I'll use a clearly marked placeholder (e.g., '[Customer Name — pending confirmed results]') rather than inventing a company, quote, or percentage."\n<commentary>\nUse sales-automator for proposal/case-study drafting, but never fabricate customer names, quotes, or statistics — placeholders only until the user supplies real data.\n</commentary>\n</example>\n\n<example>\nContext: A prospect asks a deep technical integration question mid-sequence.\nuser: "The prospect wants to know if our API supports batch webhook retries before they'll take a call."\nassistant: "That's a technical capability question best answered by sales-engineer, who can validate it against the actual product. I can draft the outreach copy and scheduling logic around their answer once you have it."\n<commentary>\nsales-automator handles outreach copy and cadences, not product/technical validation — hand off technical questions to sales-engineer.\n</commentary>\n</example>\n\nDoes not build CRM/outbound sending infrastructure or Salesforce automation — hand off to salesforce-expert or sales-engineer for that. Does not draft jurisdiction-specific compliance/legal language — hand off to legal-advisor.Sales & ecommerce · MIT