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

70%

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

56%Weight 40%Scale 1-5

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

The content is strong on actionable templates and clear narrative sequences but is held back by significant verbosity and a monolithic inline structure with no progressive disclosure. Trimming boilerplate and known concepts while splitting detailed templates into reference files would raise both weak dimensions.

Suggestions

Remove generic boilerplate ('Do not use this skill when', the 'Instructions' bullets) and condense well-known concepts like the Setup→Conflict→Resolution and narrative-arc definitions, which Claude already knows, to cut token load.

Move the three full story-framework templates, presentation templates, and the matplotlib example into separate reference files (e.g., frameworks.md, templates.md) and link to them from a lean overview, improving progressive disclosure.

Replace ASCII '[Show visualization]' placeholder blocks with either real code snippets or terse one-line descriptions so the guidance stays executable rather than illustrative.

Dimension	Reasoning	Score
Conciseness	At ~460 lines the body is noticeably verbose: generic boilerplate ('Do not use this skill when', the 'Instructions' section) plus reiteration of well-known storytelling concepts (Setup→Conflict→Resolution, narrative arc) that Claude already knows, alongside padded ASCII dashboard mockups.	2 / 5
Actionability	Provides concrete, mostly executable guidance: a real matplotlib annotation example, three full story-framework templates, a headline formula, and ready transition-phrase banks; minor gaps are the ASCII '[Show visualization]' placeholders which are illustrative rather than runnable.	4 / 5
Workflow Clarity	Multi-step story sequences are clearly laid out (Narrative Arc, the 7-slide 'Data Story Flow', Problem-Solution/Trend/Comparison frameworks) with a logical progression; no validation checkpoints are needed for this non-destructive creative skill, so it sits just below 5.	4 / 5
Progressive Disclosure	Good section structure with headers and tables, but all content is inlined into a single ~460-line SKILL.md with no bundle files and no one-level-deep references to detail files, so material that could be split (frameworks, templates, visualization code) is not progressively disclosed.	3 / 5
	Total	13 / 20 Passed

Description

83%Weight 40%Scale 1-5

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 states both capability and trigger conditions in third person with concrete trigger phrases, scoring high across all dimensions. The main gap is trigger-term breadth rather than structural flaws.

Dimension	Reasoning	Score
Specificity	Names the domain and several concrete techniques ('using visualization, context, and persuasive structure'), but these are abstract levers rather than a comprehensive list of distinct actions; not a full 5-level coverage of specific concrete actions.	4 / 5
Completeness	Explicitly answers both 'what' ('Transform data into compelling narratives...') and 'when' ('Use when presenting analytics to stakeholders, creating data reports, or building executive presentations') with concrete trigger phrases, matching the 5-anchor example closely.	5 / 5
Trigger Term Quality	Natural trigger phrases like 'presenting analytics to stakeholders', 'creating data reports', 'building executive presentations' map well to what a user would say; a few common synonyms (e.g., 'dashboards', 'data storytelling', 'KPI review') are missing.	4 / 5
Distinctiveness Conflict Risk	'Data storytelling' is a fairly distinct niche with specific stakeholder/report triggers, giving minimal conflict risk; minor overlap remains with general presentation or charting skills.	4 / 5
	Total	17 / 20 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: 3eff4af

Reviewed: 1 day 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.