Agent skill

visual-storytelling-design

Use when creating data journalism, presentations, infographics, or visual stories that need to communicate data insights through narrative structure. Invoke when user mentions data storytelling, scrollytelling, presentation design, infographic, annotated chart, data journalism, narrative visualization, or needs to transform data into compelling visual narratives.

Stars 45
Forks 6

Install this agent skill to your Project

npx add-skill https://github.com/lyndonkl/claude/tree/main/skills/visual-storytelling-design

SKILL.md

Visual Storytelling Design

Table of Contents

  • Read This First
  • Story Design Workflow
  • Path Selection Menu
    • Path 1: Build Narrative Structure
    • Path 2: Master Annotation
    • Path 3: Design Scrollytelling
    • Path 4: Apply Framing & Metaphors
  • Quick Reference
  • Guardrails

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

  1. Lead with insight, not topic — Title: "Remote workers report 23% higher satisfaction" not "Remote work survey results"
  2. Annotate the insight — Don't make readers discover it; point it out with callouts
  3. Provide context — Baselines, historical comparisons, denominators for every percentage
  4. One change at a time — Scrollytelling: highlight OR annotate, not both simultaneously
  5. 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.

Expand your agent's capabilities with these related and highly-rated skills.

lyndonkl/claude

synthesis-and-analogy

Use when synthesizing information from multiple sources (literature review, stakeholder feedback, research findings, data from different systems), creating or evaluating analogies for explanation or problem-solving (cross-domain transfer, "X is like Y", structural mapping), combining conflicting viewpoints into unified framework, identifying patterns across disparate sources, finding creative solutions by transferring principles from one domain to another, testing whether analogies hold (surface vs deep similarities), or when user mentions "synthesize", "combine sources", "analogy", "like", "similar to", "transfer from", "integrate findings", "what's it analogous to".

45 6
Explore
lyndonkl/claude

socratic-teaching-scaffolds

Use when teaching complex concepts (technical, scientific, philosophical), helping learners discover insights through guided questioning rather than direct explanation, correcting misconceptions by revealing contradictions, onboarding new team members through scaffolded learning, mentoring through problem-solving question frameworks, designing self-paced learning materials, or when user mentions "teach me", "help me understand", "explain like I'm", "learning path", "guided discovery", or "Socratic method".

45 6
Explore
lyndonkl/claude

environmental-scanning-foresight

Use when scanning external trends for strategic planning, monitoring PESTLE forces (Political, Economic, Social, Technological, Legal, Environmental), detecting weak signals (early indicators of change), planning scenarios for multiple futures, setting signposts and indicators for early warning, or when user mentions environmental scanning, horizon scanning, trend analysis, scenario planning, strategic foresight, futures thinking, or emerging issues monitoring.

45 6
Explore
lyndonkl/claude

embedding-fusion-strategy

Use when designing embedding strategies that fuse semantic and structural information for knowledge graphs. Invoke when user mentions node embeddings, structural embeddings, semantic embeddings, contrastive alignment, embedding fusion, vector representations for graphs, or combining text and graph signals. Provides embedding selection, fusion design, and implementation guidance.

45 6
Explore
lyndonkl/claude

constraint-based-creativity

Use when brainstorming feels stuck or generates obvious ideas, need to break creative patterns, working with limited resources (budget/time/tools/materials), want unconventional solutions, designing with specific limitations, user mentions "think outside the box", "we're stuck", "same old ideas", "tight constraints", "limited budget/time", or seeking innovation through limitation rather than abundance.

45 6
Explore
lyndonkl/claude

symmetry-group-identifier

Use when you've identified candidate symmetries and need to map them to mathematical groups for architecture design. Invoke when user mentions cyclic groups, dihedral groups, Lie groups, SO(3), SE(3), permutation groups, or needs to formalize symmetries into group theory language. Provides taxonomy and mathematical foundations from Visual Group Theory principles.

45 6
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results