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.

1.06x

Quality

71%

Does it follow best practices?

Impact

94%

1.06x

Average score across 3 eval scenarios

Securityby

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./tests/ext_conformance/artifacts/agents-wshobson/business-analytics/skills/data-storytelling/SKILL.md

Quality

Content

63%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.

A rich, actionable reference for data storytelling with concrete templates and executable code, but it is long and monolithic. It explains concepts Claude already knows and keeps all reference material inline rather than splitting it across bundle files.

Suggestions

Trim generic writing advice (narrative arc definitions, 'show don't tell', transition-phrase lists) that Claude already knows, to improve conciseness.

Move the full framework templates and ASCII dashboard mockups into separate reference files under ./references/ and link to them from the overview, improving progressive disclosure.

Replace placeholder brackets like '[Show engagement curve visualization]' with concrete, self-contained examples so the templates are fully copy-paste ready.

Dimension	Reasoning	Score
Conciseness	The ~450-line body is mostly useful templates, but it also explains generic storytelling concepts Claude already knows (narrative arc, rule of three, 'show don't tell', transition-phrase lists), which is padding that could be trimmed.	3 / 5
Actionability	Provides concrete, copy-paste-ready framework templates (Problem-Solution, Trend, Comparison) plus executable matplotlib code; minor gaps remain where templates use placeholders like '[Show engagement curve visualization]'.	4 / 5
Workflow Clarity	Each framework gives a clear sequenced narrative structure (Hook → Context → Insight → Recommendation → Call to Action). No validation checkpoints are needed since the skill performs no destructive or batch operations, so the cap does not apply.	4 / 5
Progressive Disclosure	No bundle files exist and the entire body is inlined in SKILL.md with good section headers, but ~450 lines of full framework templates and dashboard mockups that could live in separate reference files are all kept inline.	3 / 5
	Total	14 / 20 Passed

Description

78%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.

A strong description that clearly states both capability and trigger conditions with natural phrasing. Its main weakness is that the named capabilities ('visualization, context, persuasive structure') lean abstract rather than enumerating concrete actions.

Dimension	Reasoning	Score
Specificity	Names the domain plus a few capabilities ('visualization, context, and persuasive structure'), but those means are more abstract than the concrete actions (e.g. 'extract text, fill forms') that define a 4 or 5.	3 / 5
Completeness	Explicitly answers both what ('Transform data into compelling narratives...') and when ('Use when presenting analytics...') with concrete trigger phrases, matching the 5 anchor.	5 / 5
Trigger Term Quality	Natural trigger phrases like 'presenting analytics to stakeholders', 'creating data reports', and 'building executive presentations' are present, though common synonyms (dashboards, slide decks, quarterly reviews) are missing.	4 / 5
Distinctiveness Conflict Risk	The data-storytelling/presentation niche is mostly distinct with specific triggers, but 'data reports' and 'executive presentations' carry minor overlap with generic presentation or office skills.	4 / 5
	Total	16 / 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: Dicklesworthstone/pi_agent_rust
Path: tests/ext_conformance/artifacts/agents-wshobson/business-analytics/skills/data-storytelling/SKILL.md
Commit: 6453c0b

Reviewed: about 9 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.