Voltar ao índice
Design e UI

Narrativas claras e persuasivas com dados

Transforma análises em histórias estruturadas com contexto, visualizações, recomendações e próximos passos acionáveis.

Ver código no GitHub Instala diretamente do repositório-fonte.

O que esta skill faz

Esta skill ajuda a comunicar dados como uma narrativa orientada a decisões. Ela combina evidências, contexto e recursos visuais em uma sequência que apresenta o cenário, destaca o principal conflito ou oportunidade e conduz a recomendações.

Quando usar

  • Apresentar análises a executivos
  • Criar relatórios trimestrais ou para investidores
  • Explicar métricas a públicos não técnicos
  • Sustentar recomendações com dados

Como usar

  1. Defina a audiência e a decisão que a apresentação deve apoiar
  2. Valide os dados e identifique o insight principal
  3. Organize contexto, tensão, descoberta e recomendação
  4. Escolha visualizações que esclareçam comparações e tendências
  5. Finalize com próximos passos específicos

O que revisar antes de instalar

  • Uma narrativa convincente não corrige dados fracos ou incompletos
  • Correlação não deve ser apresentada como causalidade sem evidência
  • Visualizações precisam preservar escalas e contexto relevantes

SKILL.md

---
name: data-storytelling
description: Transform data into compelling narratives using visualization, context, and persuasive structure. Use when presenting analytics to stakeholders, creating data reports, or building executive presentations.
---

# Data Storytelling

Transform raw data into compelling narratives that drive decisions and inspire action.

## When to Use This Skill

- Presenting analytics to executives
- Creating quarterly business reviews
- Building investor presentations
- Writing data-driven reports
- Communicating insights to non-technical audiences
- Making recommendations based on data

## Core Concepts

### 1. Story Structure

```
Setup → Conflict → Resolution

Setup: Context and baseline
Conflict: The problem or opportunity
Resolution: Insights and recommendations
```

### 2. Narrative Arc

```
1. Hook: Grab attention with surprising insight
2. Context: Establish the baseline
3. Rising Action: Build through data points
4. Climax: The key insight
5. Resolution: Recommendations
6. Call to Action: Next steps
```

### 3. Three Pillars

| Pillar        | Purpose  | Components                       |
| ------------- | -------- | -------------------------------- |
| **Data**      | Evidence | Numbers, trends, comparisons     |
| **Narrative** | Meaning  | Context, causation, implications |
| **Visuals**   | Clarity  | Charts, diagrams, highlights     |

## Detailed patterns and worked examples

Detailed pattern documentation lives in `references/details.md`. Read that file when the navigation tier above is insufficient.

## Best Practices

### Do's

- **Start with the "so what"** - Lead with insight
- **Use the rule of three** - Three points, three comparisons
- **Show, don't tell** - Let data speak
- **Make it personal** - Connect to audience goals
- **End with action** - Clear next steps

### Don'ts

- **Don't data dump** - Curate ruthlessly
- **Don't bury the insight** - Front-load key findings
- **Don't use jargon** - Match audience vocabulary
- **Don't show methodology first** - Context, then method
- **Don't forget the narrative** - Numbers need meaning