data-storytelling

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

Quality

66%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./skills/data-storytelling/SKILL.md

Quality

Content

65%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The skill is highly actionable thanks to rich, reusable templates and code, but it is overlong and monolithic, and its actual production workflow guidance is generic with no verification checkpoints.

Suggestions

Move the three full framework templates and presentation templates into separate reference files (e.g. FRAMEWORKS.md, TEMPLATES.md) and keep SKILL.md as a lean overview with one-level-deep links.

Replace the generic Instructions with a concrete, sequenced workflow (clarify audience → pick framework → draft headline → assemble evidence → verify the recommendation holds) with explicit checkpoints.

Trim restated basics like "Setup → Conflict → Resolution" and consolidate overlapping frameworks to reduce length while keeping the actionable examples.

Dimension	Reasoning	Score
Conciseness	The body is mostly concrete templates and examples, but at roughly 460 lines it is verbose with overlapping frameworks and templates, and it re-states basic storytelling concepts ("Setup → Conflict → Resolution") Claude already knows.	2 / 3
Actionability	It provides three full copy-paste framework templates, executable matplotlib annotation code, headline formulas, and banks of transition phrases that are directly reusable.	3 / 3
Workflow Clarity	The "Instructions" section is vague ("Apply relevant best practices and validate outcomes"), and while the story-arc and flow templates give a sequence, there are no validation checkpoints or feedback loops for the production process.	2 / 3
Progressive Disclosure	There are no bundle files and sections are well organized, but the ~460-line body is monolithic with frameworks and templates that could be split into one-level-deep reference files.	2 / 3
	Total	9 / 12 Passed

Description

67%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description cleanly covers both capability and explicit use-when triggers, but leans on slightly fluffy language and omits the most common data-visualization trigger terms, leaving it less distinctive and less specific than it could be.

Suggestions

Replace fluffy phrasing ("compelling narratives," "persuasive structure") with concrete verbs such as designing charts, structuring insights, and building slide narratives.

Add high-frequency trigger terms users actually say, e.g. "data visualization," "charts," "dashboards," or "turning data into a story."

Sharpen distinctiveness by scoping triggers to data-driven communication specifically, distinguishing it from general presentation or slide-building skills.

Dimension	Reasoning	Score
Specificity	Names the domain and several components ("visualization, context, and persuasive structure"), but these read as abstract techniques rather than concrete actions, and phrases like "compelling narratives" and "persuasive structure" trend toward fluff.	2 / 3
Completeness	It explicitly answers both what ("Transform data into compelling narratives using visualization, context, and persuasive structure") and when ("Use when presenting analytics to stakeholders, creating data reports, or building executive presentations").	3 / 3
Trigger Term Quality	Triggers such as "presenting analytics," "data reports," and "executive presentations" are natural, but core user terms for this domain like "data visualization," "charts," and "dashboards" are absent.	2 / 3
Distinctiveness Conflict Risk	The data-narrative niche is reasonably clear, but triggers like "creating data reports" and "executive presentations" could overlap with generic presentation or reporting skills.	2 / 3
	Total	9 / 12 Passed

Validation

100%

Warnings & errors only

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository: rmyndharis/antigravity-skills
Path: skills/data-storytelling/SKILL.md
Commit: e63f7dd

Reviewed: about 5 hours ago

Table of Contents

Discovery Implementation Validation

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.