CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

data-storyteller

Use when building data-heavy screens, analytics dashboards, metric visualizations, or inline charts for Copilot. Creates bar/line charts, renders data tables, aggregates KPI metrics, builds filterable dashboard layouts, and generates HTML previews for concept validation. Triggers: 'dashboard', 'métricas', 'gráfico', 'chart', 'visualización', 'analytics', 'KPI', 'reporte', 'muestra los datos', 'cómo van los números'.

68

Quality

85%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

77%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 dense, well-sequenced design workflow with explicit gates, validation checkpoints, and largely executable guidance (real paths, commands, and query templates). Its main weaknesses are a dangling reference to a non-existent data-viz-conventions.md, an orphaned metrics-map.md that the body never navigates to, and small amounts of trimmable role-section filler.

Suggestions

Fix the dangling reference: either add references/data-viz-conventions.md or repoint line 132 to an existing file (e.g. merge channel color conventions into chart-selection-guide.md).

Wire references/metrics-map.md into the workflow (e.g. in Phase D4/P4 metric validation) so the bundled file is discoverable.

Tighten the <role> section: replace 'Know chart types, when each works...' style filler with the specific behavioral rules already stated, and move the 'paradigm v4 post 2026-05-06' date into the legacy/archive note where the PI-1..PI-12 reference already lives.

DimensionReasoningScore

Conciseness

The body is dense and table-driven with almost no explanation of concepts Claude already knows, e.g. the Quick Reference table and terse Design Rules. It is not a 5 because the <role> section contains trimmable filler ('Know chart types, when each works, and when it fails') and inline time-sensitive detail ('paradigm v4 post 2026-05-06') sits outside any legacy/deprecated section.

4 / 5

Actionability

Most guidance is executable: concrete Grep/Glob paths ('backend/src/modules/analytics/api/'), a runnable Bash audit command ('docker exec -t visionarias_client_dev npm ls ... | grep -iE "chart|recharts|..."'), MCP query templates, and WebSearch site: queries. It is not a 5 because several steps remain conversational directives rather than copy-paste-ready commands (e.g. HTML preview steps reference a template flow without full detail).

4 / 5

Workflow Clarity

The multi-mode workflow is clearly sequenced with explicit gates ('Gate: Do NOT proceed without knowing what data exists...'), validation phases (D4/P4), a user-confirmation feedback loop ('Gate: User confirms the proposal meets their need'), and an ambiguity fallback question in Mode Detection. This matches the top anchor for clear sequence with explicit validation and feedback loops.

5 / 5

Progressive Disclosure

Structure exists and existing references are clearly signaled ('Read references/chart-selection-guide.md', 'Load references/viz-spec-template.md'), but navigation is incomplete: the body cites 'references/data-viz-conventions.md' which does not exist in the bundle, and the provided 'references/metrics-map.md' is never referenced from SKILL.md. This fits 'some structure but could be better organized' better than the minor-gaps anchor at 4.

3 / 5

Total

16

/

20

Passed

Description

88%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 explicitly answers both what the skill does and when to use it, with concrete actions and a well-chosen bilingual trigger list including colloquial user phrasing. Remaining weaknesses are minor: a few natural trigger synonyms are absent, and broad terms like 'chart'/'analytics' slightly increase conflict risk with generic dataviz skills.

DimensionReasoningScore

Specificity

"Creates bar/line charts, renders data tables, aggregates KPI metrics, builds filterable dashboard layouts, and generates HTML previews for concept validation" lists five concrete actions with comprehensive domain coverage, matching the anchor for multiple specific concrete actions. It does not fall to 4 because coverage spans creation, aggregation, layout, and preview generation without notable gaps.

5 / 5

Completeness

Both 'what' ("Creates bar/line charts, renders data tables, aggregates KPI metrics, builds filterable dashboard layouts, and generates HTML previews") and 'when' ("Use when building data-heavy screens, analytics dashboards, metric visualizations, or inline charts for Copilot" plus an explicit Triggers list) are clearly and explicitly stated with concrete trigger phrases, matching the top anchor.

5 / 5

Trigger Term Quality

The explicit "Triggers:" list covers natural bilingual terms including colloquial phrases users actually say ('muestra los datos', 'cómo van los números'), 'dashboard', 'gráfico', 'chart', 'KPI'. It stops short of 5 because common variations like 'tabla', 'graph', 'trend', or 'sales report' are missing, leaving a few natural terms uncovered.

4 / 5

Distinctiveness Conflict Risk

The domain (data-heavy screens, dashboards, KPI visualizations, Copilot inline charts) is a clear niche, but broad triggers like 'chart', 'analytics', and 'dashboard' create minor overlap risk with a general charting/dataviz skill. It is mostly distinct rather than fully distinct, so it fits the anchor at 4 rather than 5.

4 / 5

Total

18

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

referenced_paths_exist

Referenced path issues: 1 missing

Warning

Total

15

/

16

Passed

Repository

alpacapurpura/luana-method

Path

claude/skills/data-storyteller/SKILL.md

Reviewed

Table of Contents

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.