跳到正文
cccskills
免费在 GitHub 公开

visual-storytelling-design

Transforms data into compelling visual narratives by applying narrative structure, annotation techniques, scrollytelling patterns, and honest framing to data journalism, presentations, and infographics. Use when creating data-driven articles or reports, designing infographics with narrative, building scrollytelling experiences, annotating charts to guide interpretation, or when user mentions data storytelling, presentation design, annotated chart, narrative visualization.

中文简介正在准备中。当前显示原文说明。

查看安装方法

包含的文件(4)

  • SKILL.md4.8 KB
  • resources/evaluators/rubric_visual_storytelling.json4.0 KB
  • resources/narrative-techniques.md7.2 KB
  • resources/storytelling-patterns.md7.0 KB

SKILL.md(原文)

安装前可以查看交给 AI 代理的指令内容。

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.

评价

还没有评价。欢迎分享你的使用感受。

评论

无需登录即可发表。欢迎分享使用感受、提问,或说明在哪些环境下无法运行。

还没有评论。来写第一条吧。

提交后会立即公开。请勿填写邮箱、电话等个人信息。URL 最多 2 个。

0 / 1000 字

此表单受 reCAPTCHA 保护,适用 Google 的隐私权政策和服务条款。

同一仓库的技能

使用 AACT (Aggregate Analysis of ClinicalTrials.gov) PostgreSQL 数据仓库进行批量、历史、聚合性临床试验数据挖掘。Use this skill when the user requests bulk SQL analysis over the full clinical trials data warehouse — historical trial trends, disease landscapes, similar-design matching, or multi-year aggregations across hundreds of thousands of NCT records. 触发场景包括:AACT 查询、临床试验批量分析、PostgreSQL 试验数据、全量 NCT 检索、试验数据挖掘、历史试验分析、clinical trials data warehouse、SQL trials、bulk trial analysis、disease landscape、试验设计相似性匹配、跨年度聚合、sponsor/phase/country 多维统计。**与 clinical-trials-v2 差异**:本 skill 走批量 SQL · 离线大数据(PostgreSQL);v2 走实时 API · 单查询。两者互补:单条 NCT 实时状态用 v2,百万级历史挖掘用本 skill。支持云端公共 PostgreSQL(aact-db.ctti-clinicaltrials.org · 零部署)和每日 dump 本地还原(高性能 · 离线)两种连接方式,自动检测优先用本地。跨平台(macOS/Linux/Windows)参数化 SQL 防注入,read-only 强制保护。

中文简介正在准备中。当前显示原文说明。

EthanYoQ/Skill-hub112026年10月19日 更新

使用 AACT (Aggregate Analysis of ClinicalTrials.gov) PostgreSQL 数据库进行大批量临床试验历史分析与数据挖掘。触发场景包括:AACT 查询、临床试验批量分析、PostgreSQL 试验数据、全量 NCT 检索、试验数据挖掘、clinical trials data warehouse、疾病领域全景分析、设计相似试验匹配、跨年度试验趋势聚合。本 skill 通过 SQL 接口处理百万级试验记录,支持云端公共 PostgreSQL 服务(aact-db.ctti-clinicaltrials.org)和每日 dump 本地还原两种连接方式,自动检测并优先使用本地高性能模式。

中文简介正在准备中。当前显示原文说明。

EthanYoQ/Skill-hub112026年10月19日 更新

Use when work produces a deliverable, factual claim, dataset, code change, decision, publication, deployment, automation, or irreversible action whose failure would matter; when the user asks for a quality gate, acceptance criteria, QA, completeness, validation, audit, evidence, preflight, release readiness, or a definition of done; or before claiming completion on medium- or high-risk work. Automatically decide whether a formal gate is warranted, derive task-specific pass/fail criteria, gather evidence, and block unsupported completion. Make sure to use this skill even when the user does not say "quality gate" if consequential work needs acceptance criteria or completion evidence. Skip formal gating for trivial, reversible, low-impact requests.

中文简介正在准备中。当前显示原文说明。

EthanYoQ/Skill-hub112026年10月19日 更新

Create a changeset file in .changeset/ that describes a user-facing change for the release notes

中文简介正在准备中。当前显示原文说明。

EthanYoQ/Skill-hub112026年10月19日 更新

Add a new competitor to the AI Visibility Tool Directory — researches the tool, generates data, takes a screenshot, and inserts into the codebase

中文简介正在准备中。当前显示原文说明。

EthanYoQ/Skill-hub112026年10月19日 更新

add-lang

免费

Add tree-sitter language support to codegraph end-to-end — wire the grammar + extractor, write tests, then benchmark extraction quality and retrieval value on 3 popular real-world repos. Use when the user runs /add-lang <language> or asks to add/support a new language (e.g. Lua, Elixir, Zig, OCaml) in codegraph.

中文简介正在准备中。当前显示原文说明。

EthanYoQ/Skill-hub112026年10月19日 更新

查看 EthanYoQ 的全部技能

报告此技能的问题