visual-storytelling-design
npx skills add https://github.com/lyndonkl/claude --skill visual-storytelling-design
Agent 安装分布
Skill 文档
Visual Storytelling Design
Table of Contents
Read This First
What This Skill Does
This skill helps you transform data into compelling visual narratives â data journalism, presentations, infographics, and interactive stories that communicate insights through narrative structure.
Core principle: People naturally seek stories with cause-effect and chronology. Structuring data as narrative aids comprehension and retention.
Why It Matters
Challenges of data storytelling:
- Raw data is a heap of facts â hard to process
- Visualizations can be misinterpreted without guidance
- Readers skim, don’t read thoroughly
- Need emotional engagement AND factual accuracy
How cognitive principles help:
- Narrative structure chunks information meaningfully (Context â Problem â Evidence â Insight)
- Annotations guide attention to key insights (prevent misinterpretation)
- Progressive disclosure reveals complexity gradually (scrollytelling)
- Framing provides context for accurate interpretation
When to Use This Skill
Use this skill when:
- â Creating data-driven articles, reports, or presentations
- â Designing infographics or data visualizations with narrative
- â Building scrollytelling or interactive data experiences
- â Annotating charts to guide interpretation
- â Framing data with honest context and comparisons
Do NOT use for:
- â Learning cognitive principles (use
cognitive-design) - â Implementing D3.js visualizations (use
d3-visualization) - â Evaluating designs (use
design-evaluation-audit) - â Checking for misleading patterns (use
cognitive-fallacies-guard)
Story Design Workflow
Time: 1-2 hours
Copy this checklist and track your progress:
Story Design Progress:
- [ ] Step 1: Define Narrative
- [ ] Step 2: Choose Structure
- [ ] Step 3: Apply Cognitive Techniques
- [ ] Step 4: Review for Clarity & Integrity
Step 1: Define Narrative
Determine the story arc: What’s the context? What’s the question/problem? What data answers it? What’s the insight? Choose an opening strategy: lead with human impact, surprising finding, or visual.
Resource: Narrative Techniques â Narrative Structure section
Step 2: Choose Structure
Select a template and pattern that fits your story type, audience, and medium. Options include step-by-step article, magazine style, annotated chart, interactive exploration, or presentation deck.
Resource: Storytelling Patterns â Templates and Decision Matrix
Step 3: Apply Cognitive Techniques
Add annotations (callouts, arrows, shaded regions, direct labels). Apply framing with baselines, comparisons, and denominator clarity. Use scrollytelling for progressive revelation if web-based. Consider visual metaphors.
Resource: Narrative Techniques â Annotations, Scrollytelling, Framing sections
Step 4: Review for Clarity & Integrity
Verify the story is honest (no cherry-picking, balanced framing), clear (insight obvious in 5 seconds), and complete (sources cited, limitations noted). Use design-evaluation-audit for systematic evaluation and cognitive-fallacies-guard for integrity verification.
Path Selection Menu
Path 1: Build Narrative Structure
Choose this when: Starting a data story and need to define the narrative arc and opening strategy.
â Go to Narrative Techniques â Sections 1-2
Path 2: Master Annotation
Choose this when: Adding annotations to guide interpretation of existing charts and visualizations.
â Go to Narrative Techniques â Section 3
Path 3: Design Scrollytelling
Choose this when: Building web-based progressive revelation experiences.
â Go to Narrative Techniques â Section 4
Path 4: Apply Framing & Metaphors
Choose this when: Providing context, baselines, comparisons, and visual metaphors.
â Go to Narrative Techniques â Sections 5-6
Quick Reference
5 Storytelling Principles
- Lead with insight, not topic â Title: “Remote workers report 23% higher satisfaction” not “Remote work survey results”
- Annotate the insight â Don’t make readers discover it; point it out with callouts
- Provide context â Baselines, historical comparisons, denominators for every percentage
- One change at a time â Scrollytelling: highlight OR annotate, not both simultaneously
- Be honest â Show full data, acknowledge limitations, avoid cherry-picking
Guardrails
This skill does NOT: Implement code, evaluate general usability, teach cognitive theory, or check for misleading patterns.
This skill DOES: Provide narrative structure, annotation techniques, scrollytelling patterns, framing guidance, story templates, and quality checklists for data storytelling.