mcpField
V
visual-storytelling-design

visual-storytelling-design

github.com/lyndonklDesign & UI187221 installsUpdated 10w ago
Repository

About visual-storytelling-design

A skill for designing data stories through narrative structure, annotations, framing, and scrollytelling. It helps data storytellers choose an approach and review visual explanations for clarity and integrity.

Key features

  1. 01Narrative arcs and opening strategies
  2. 02Annotations that direct attention
  3. 03Framing with baselines and comparisons
  4. 04Scrollytelling for progressive disclosure
  5. 05Clarity and integrity review checklist

Use cases

  1. 01Planning a narrative for a data visualization
  2. 02Annotating a chart to make its insight clear
  3. 03Designing progressive disclosure for a web story

Install

Copy the command and run it in a terminal.

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

After installing, type/visual-storytelling-designin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

resources/
narrative-techniques.md
storytelling-patterns.md
resources/evaluators/
rubric_visual_storytelling.json

Details

From the project README

Visual Storytelling Design

Table of Contents


Core principle: Structuring data as narrative (Context → Problem → Evidence → Insight) aids comprehension and retention. Annotations guide attention, progressive disclosure reveals complexity gradually, and framing provides context for accurate interpretation.

Related skills: Use cognitive-design for cognitive principles, d3-visualization for D3.js implementation, design-evaluation-audit for systematic evaluation, cognitive-fallacies-guard for integrity checks.


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

Scope: This skill provides narrative structure, annotation techniques, scrollytelling patterns, framing guidance, story templates, and quality checklists for data storytelling. It does not implement code, evaluate general usability, teach cognitive theory, or check for misleading patterns.

Comments

Markdown supported