
communication-storytelling
Transforms analysis, data, and complex information into clear, persuasive narratives tailored to specific audiences — executives, customers, investors, or non-technical stakeholders. Provides story structures (Hero's Journey, Problem-Solution-Benefit, Situation-Complication-Resolution) and audience adaptation techniques. Use when presenting findings, explaining technical concepts to non-technical audiences, writing announcements, or when user mentions "write this for", "explain to", "present findings", "make this compelling", or "audience is".
- Installs
- 239
- Last 24h
- —
- Trending rank
- —
- Security
- Not audited
Install
Works with every agent the skills CLI supports.
npx skills add https://github.com/lyndonkl/claude --skill communication-storytelling- 01
Install
Run the command in your project. The CLI asks which agents to install for.
- 02
Describe the task
Ask your agent for something this skill covers. It loads communication-storytelling automatically when relevant.
- 03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.
SKILL.md
The instructions your agent reads when the skill is triggered.
Communication Storytelling
Table of Contents
Overview
This skill crafts compelling stories using a structured framework: (1) Headline — single clear statement capturing the essence, (2) Key Points — 3-5 supporting ideas with logical flow, (3) Proof — evidence, data, examples that substantiate, (4) Call-to-Action — what audience should think, feel, or do.
Quick example:
Bad (data dump): "Our Q2 revenue was $2.3M, up from $1.8M in Q1. Customer count went from 450 to 520. Churn decreased from 5% to 3.2%. NPS improved from 42 to 58. We launched 3 new features..."
Good (storytelling): "We've reached product-market fit. Three signals prove it: (1) Revenue grew 28% while sales capacity stayed flat—customers are pulling product from us, not the other way around. (2) Churn dropped 36% as we focused on power users, with our top segment now at 1% monthly churn. (3) NPS jumped 16 points to 58, with customers specifically praising the three features we bet on. Recommendation: Double down on power user segment with premium tier."
Workflow
Copy this checklist and track your progress:
Communication Storytelling Progress:
- [ ] Step 1: Gather inputs and clarify audience
- [ ] Step 2: Choose appropriate narrative structure
- [ ] Step 3: Craft the narrative
- [ ] Step 4: Validate quality and clarity
- [ ] Step 5: Deliver and adapt
Step 1: Gather inputs and clarify audience
Ask user for the message (analysis, data, information to communicate), audience (who will receive this), purpose (inform, persuade, inspire, build trust), context (situation, stakes, constraints), and tone (formal, casual, urgent, celebratory). Understanding audience deeply is critical—their expertise level, concerns, decision authority, and time constraints shape everything. See resources/template.md for input questions.
Step 2: Choose appropriate narrative structure
For standard communications (announcements, updates, presentations) → Use resources/template.md quick template. For complex multi-stakeholder communications requiring different versions → Study resources/methodology.md for audience segmentation and narrative adaptation techniques. To see what good looks like → Review resources/examples/.
Step 3: Craft the narrative
Create communication-storytelling.md with: (1) Compelling headline that captures essence in one sentence, (2) 3-5 key points arranged in logical flow (chronological, problem-solution, importance-ranked), (3) Concrete proof for each point (data, examples, quotes, stories), (4) Clear call-to-action stating what audience should do next. Use storytelling techniques: specificity over generality, show don't tell, human stories over abstract concepts, tension/resolution arcs. See Story Structure for narrative patterns.
Step 4: Validate quality and clarity
Self-assess using resources/evaluators/rubric_communication_storytelling.json. Check: headline is clear and compelling, key points are distinct and well-supported, proof is concrete and relevant, flow is logical, tone matches audience, jargon is appropriate for expertise level, call-to-action is clear and achievable, length matches time constraints. Read aloud to test clarity. Test with "so what?" question—does each point answer why audience should care? Minimum standard: Average score ≥ 3.5 before delivering.
Step 5: Deliver and adapt
Present the completed communication-storytelling.md file. Highlight how narrative addresses audience's key concerns. Note storytelling techniques used (data humanized, tension-resolution, specificity). If user has feedback or needs adaptations for different audiences, use resources/methodology.md for multi-version strategy.
Story Structure
The Hero's Journey (Transformation Story)
When to use: Major changes, pivots, overcoming challenges
Structure:
- Status Quo - Where we were (comfort, but problem lurking)
- Call to Adventure - Why we had to change (problem emerges)
- Trials - What we tried, what we learned (struggle builds credibility)
- Victory - What worked (resolution)
- Return with Knowledge - What we do now (new normal, lessons learned)
Example: "We were growing 20% YoY, but churning 10% monthly—unsustainable. Data showed we were solving the wrong problem for the wrong users. We tested 5 hypotheses over 3 months, failing at 4. The one that worked: focusing on power users willing to pay 5x more. Churn dropped to 2%, growth hit 40% YoY. Now we're betting everything on premium tier."
Problem-Solution-Benefit (Decision Story)
When to use: Recommendations, proposals, project updates
Structure:
- Problem - Clearly defined issue with stakes (what happens if unaddressed)
- Solution - Your recommendation with rationale (why this, not alternatives)
- Benefit - Tangible outcomes (quantified impact)
Example: "We lose 30% of signups at checkout—$2M ARR left on table. Root cause: we ask for credit card before users see value. Proposal: 14-day trial, no card required, with onboarding emails showing ROI. Comparable companies saw 60% conversion lift. Expected impact: +$1.2M ARR with 4-week implementation."
Before-After-Bridge (Contrast Story)
When to use: Product launches, feature announcements, process improvements
Structure:
- Before - Current painful state (audience's lived experience)
- After - Improved future state (what becomes possible)
- Bridge - How to get there (your solution)
Example: "Before: Sales team spends 10 hours/week manually exporting data, cleaning it in spreadsheets, and copy-pasting into slide decks—error-prone and soul-crushing. After: One-click report generation with live data, auto-refreshing dashboards, 30 minutes per week. Bridge: We built sales analytics v2.0, launching Monday with training sessions."
Situation-Complication-Resolution (Executive Story)
When to use: Executive communications, board updates, investor relations
Structure:
- Situation - Context and baseline (set the stage)
- Complication - What changed or what's at stake (creates tension)
- Resolution - Your path forward (release tension)
Example: "Situation: We budgeted $5M for customer acquisition in 2024. Complication: iOS 17 privacy changes killed our primary ad channel—50% drop in conversion overnight. Resolution: Shifting $2M to content marketing (3-month ROI), $1M to partnerships (immediate distribution), keeping $2M in ads for testing new channels. Risk: content takes time to scale, but partnerships derisk timeline."
Common Patterns
Data-Heavy Communications:
- Lead with insight, not data
- One number per point (too many = confusion)
- Humanize data with stories: "42% churn" → "We lose 12 customers every week—that's Sarah's entire cohort from January"
- Use comparisons for context: "200ms latency" → "2x slower than competitors, 3x slower than last year"
Technical → Non-Technical:
- Translate jargon: "distributed consensus algorithm" → "how servers agree on truth without a central authority"
- Use analogies from audience's domain: "Kubernetes is like a airport air traffic control for containers"
- Focus on business impact, not technical implementation
- Anticipate "why does this matter?" and answer it explicitly
Change Management:
- Acknowledge the loss/pain (don't gloss over difficulty)
- Paint compelling future state (hope, not just fear)
- Show path from here to there (make it concrete)
- Address "what about me?" early (personal impact)
Crisis Communications:
- Lead with facts (what happened, when, impact)
- Take accountability (no blame-shifting or weasel words)
- State what you're doing (concrete actions with timeline)
- Commit to transparency (when they'll hear next)
Guardrails
Do:
- ✅ Test headline clarity—can someone understand the essence in 10 seconds?
- ✅ Use concrete specifics over vague generalities
- ✅ Match sophistication level to audience (avoid talking up or down)
- ✅ Front-load conclusions (executives decide in first 30 seconds)
- ✅ Show your work for major claims (data sources, assumptions)
- ✅ Acknowledge limitations and risks (builds credibility)
Don't:
- ❌ Bury the lede (most important thing must be first)
- ❌ Use jargon your audience doesn't know (or define it)
- ❌ Make claims without proof (erodes trust)
- ❌ Assume audience cares—make them care by showing stakes
- ❌ Write walls of text (use bullets, headers, white space)
- ❌ Lie or mislead (including by omission)
Red Flags:
- 🚩 Your draft is mostly bullet points with no narrative arc
- 🚩 You can't summarize your message in one sentence
- 🚩 You use passive voice to avoid accountability ("mistakes were made")
- 🚩 You include data that doesn't support your points
- 🚩 Your call-to-action is vague ("be better," "work harder")
Quick Reference
Resources:
- resources/template.md - Quick-start template with headline, key points, proof structure
- resources/methodology.md - Advanced techniques for multi-stakeholder communications, narrative frameworks, persuasion principles
- resources/examples/ - Worked examples showing different story structures and audiences
- resources/evaluators/rubric_communication_storytelling.json - 10-criteria quality rubric with audience-based thresholds
When to use which resource:
- Standard communication → Start with template.md
- Multiple audiences for same message → Study methodology.md multi-version strategy
- Complex persuasion (board pitch, investor update) → Study methodology.md persuasion frameworks
- Unsure what good looks like → Review examples/ for your scenario
- Before delivering → Validate with rubric (score ≥ 3.5 required)
FAQ
What does the communication-storytelling skill do?
Transforms analysis, data, and complex information into clear, persuasive narratives tailored to specific audiences — executives, customers, investors, or non-technical stakeholders. Provides story structures (Hero's Journey, Problem-Solution-Benefit, Situation-Complication-Resolution) and audience adaptation techniques. Use when presenting findings, explaining technical concepts to non-technical audiences, writing announcements, or when user mentions "write this for", "explain to", "present findings", "make this compelling", or "audience is".
How do I install communication-storytelling?
Run npx skills add https://github.com/lyndonkl/claude --skill communication-storytelling in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/communication-storytelling/ (personal) or .claude/skills/communication-storytelling/ (project).
Which AI agents can use communication-storytelling?
Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.
Is communication-storytelling safe to install?
No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.
Who maintains communication-storytelling?
It is published by lyndonkl in lyndonkl/claude. It has 239 recorded installs.
More from lyndonkl/claude
evaluation-rubrics
lyndonkl/claude
Designs structured scoring tools with explicit criteria, performance scales, and descriptors for consistent, transparent quality assessment. Use when need quality criteria and scoring scales to evaluate work consistently, compare alternatives objectively, set acceptance thresholds, reduce subjective bias, or when user mentions rubric, scoring criteria, quality standards, evaluation framework, inter-rater reliability, or grading/assessing work.
strategy-and-competitive-analysis
lyndonkl/claude
Develops business strategies grounded in rigorous competitive and market analysis using proven frameworks (Good Strategy kernel, Porter's 5 Forces, SWOT, Blue Ocean, Playing to Win, Value Chain Analysis, BCG Matrix). Use when developing strategy (market entry, product launch, expansion, M&A, turnaround), conducting competitive analysis, making strategic decisions (build vs buy, pricing, positioning), planning strategic initiatives, or when user mentions strategy, competitive analysis, Porter's 5 Forces, SWOT, market positioning, or strategic frameworks.
scientific-manuscript-review
lyndonkl/claude
Guides systematic multi-pass review and editing of scientific manuscripts (research articles, reviews, perspectives) to improve clarity, structure, scientific rigor, and reader comprehension. Use when reviewing or editing research manuscripts, journal articles, or perspectives, when user mentions manuscript, paper draft, article, research writing, journal submission, reviewer feedback, or needs to improve scientific writing.
memory-retrieval-learning
lyndonkl/claude
Open the skill to read its SKILL.md instructions.
socratic-teaching-scaffolds
lyndonkl/claude
Guides learners to discover knowledge through strategic Socratic questioning and progressive scaffolding removal. Combines question ladders, misconception detectors, Feynman explanations, and worked-example fading to build durable understanding. Use when teaching complex concepts, correcting misconceptions, onboarding team members, mentoring problem-solving, or designing self-paced learning. Use when user mentions "teach me", "help me understand", "explain like I'm", "learning path", "guided discovery", or "Socratic method".
grant-proposal-assistant
lyndonkl/claude
Guides creation and review of competitive grant proposals (NIH R01/R21/K, NSF, foundations) by applying reviewer-perspective thinking to ensure clear hypotheses, compelling significance, genuine innovation, and feasible approaches. Use when writing or reviewing grant proposals, crafting specific aims, drafting significance/innovation/approach sections, or when user mentions R01, R21, K-series, grant writing, proposal review, study section, or fundable hypothesis.
Popular docs & writing skills
grill-with-docs
mattpocock/skills
A relentless interview to sharpen a plan or design, which also creates docs (ADR's and glossary) as we go.
lark-markdown
open.feishu.cn
飞书 Markdown:查看、创建、上传、编辑和比较飞书中的原生 Markdown 文件。当用户要操作飞书 Markdown 文件,或比较其远端版本及本地草稿时使用。纯本地 Markdown 文件操作不触发本 skill。不负责将 Markdown 导入为飞书在线文档,也不负责文件搜索、权限、评论、移动、删除等云空间管理操作。
writing-beats
mattpocock/skills
Writing, exploit; assemble raw material into a journey of beats, grounding each term before a beat leans on it.
writing-shape
mattpocock/skills
Writing, exploit: shape raw material into an article, paragraph by paragraph.
writing-fragments
mattpocock/skills
Writing, explore: mine raw fragments, no structure yet.
writing-for-agents
mattpocock/skills
Writing documents for agents. Use when creating or editing skills, or modifying AGENTS.md or CLAUDE.md.