# visual-storytelling-design

visual-storytelling-design turns datasets into visual stories with narrative structure, chart annotations, scrollytelling, and clearer framing. Use it for reports, presentations, and infographics.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 235 installs · ★ 203 repo stars
- Author: lyndonkl
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/lyndonkl/claude/tree/HEAD/skills/visual-storytelling-design/SKILL.md
- Updated: 2026-09-01
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/visual-storytelling-design

## What it does

This skill guides a data-story project from the initial question to a readable conclusion. It helps choose an article, interactive piece, annotated chart, or slide deck, then shapes the material around the audience’s path through the evidence.

Its workflow covers story definition, format selection, visual attention cues, and a final clarity check. The guidance includes callouts, arrows, highlighted regions, baselines, comparisons, and clearer denominators for percentages. Web projects can use staged reveal so the page introduces one visual change at a time.

The skill does not implement visualization code or audit general usability. It also leaves misleading-pattern checks to separate skills, so it is best used for planning and reviewing the story rather than building the interface itself.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add lyndonkl/claude --skill visual-storytelling-design -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/visual-storytelling-design/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/visual-storytelling-design/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add lyndonkl/claude --skill visual-storytelling-design -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/visual-storytelling-design/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add lyndonkl/claude --skill visual-storytelling-design -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/visual-storytelling-design/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install lyndonkl/claude skills/visual-storytelling-design
```

2. **Manually: put the files in place**
- File: `.github/skills/visual-storytelling-design/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add lyndonkl/claude --skill visual-storytelling-design -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/lyndonkl/claude --path skills/visual-storytelling-design
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/visual-storytelling-design/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add lyndonkl/claude --skill visual-storytelling-design -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/lyndonkl/claude/tree/HEAD/skills/visual-storytelling-design/SKILL.md

## When to use it
- shape a data-driven article around a clear question
- choose a format for a presentation or interactive story
- point readers to the key finding on a chart
- add baselines and limits to statistical claims

## Example prompts
- Plan a visual story for this survey report and suggest a strong opening.
- Turn this chart into an annotated graphic that makes the main finding easy to spot.
- Design a scrollytelling sequence for this web article, revealing the evidence one step at a time.

## Similar
- [data-storytelling](https://affpapa.org/en/nevibecode/skills/data-storytelling.md) — skill · 16782 installs
- [scroll-world-storytelling](https://affpapa.org/en/nevibecode/skills/scroll-world-storytelling.md) — skill · 2000 installs
- [visual-content](https://affpapa.org/en/nevibecode/skills/visual-content.md) — skill · 2400 installs
- [antv-infographic](https://affpapa.org/en/nevibecode/skills/antv-infographic.md) — skill · 267 installs
- [visualization-strategy-and-critique](https://affpapa.org/en/nevibecode/skills/visualization-strategy-and-critique.md) — skill · 22 installs
- [visual-pr](https://affpapa.org/en/nevibecode/plugins/visual-pr.md) — plugin · ★ 41430 repo stars

From the same set: [lyndonkl/claude](https://affpapa.org/en/nevibecode/by/lyndonkl/claude.md) — 49 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
