CtrlK
BlogDocsLog inGet started
Tessl Logo

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'.

74

Quality

93%

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

88%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 well-structured workflow skill: executable commands, explicit gates, and proper use of reference files for bulk detail. The main defects are a broken reference (data-viz-conventions.md), an orphaned bundle file (metrics-map.md), and a Quick Reference table that duplicates the phase sections.

Suggestions

Fix the broken reference in Phase D3/P3: the body points to references/data-viz-conventions.md for "channel color conventions and common design mistakes", but that file does not exist — create it or remove the pointer.

Either wire references/metrics-map.md into the workflow (e.g., in Phase D1's data inventory or Knowledge Routing) or drop it from the bundle, since it is currently orphaned.

Trim the Quick Reference table or the per-phase headers — they cover the same phase/gate information twice and cost tokens on every load.

DimensionReasoningScore

Conciseness

The body is dense and directive — no explanations of concepts Claude already knows, tables carry information efficiently — but the Quick Reference table substantially duplicates the per-phase sections that follow it, and a few rows (e.g., "Read: corresponding DTOs → understand available fields") restate obvious steps. This fits 'efficient; minor instances of over-explanation that could be trimmed' rather than the lean every-token-earns-its-place anchor.

4 / 5

Actionability

Guidance is copy-paste ready throughout: concrete Glob/Grep patterns ("Grep: backend/src/modules/analytics/api/"), an executable library audit command ("docker exec -t visionarias_client_dev npm ls 2>/dev/null | grep -iE 'chart|recharts|visx|tremor|nivo|apex'"), specific MCP query templates, and directed search queries ("site:business-api.tiktok.com \"{metric_name}\""). This matches the fully-executable anchor covering common cases; minor placeholders like {timestamp} are parameterization, not gaps.

5 / 5

Workflow Clarity

Two clearly sequenced flows (D1→D4→Spec, P1→P4→Spec) with mode detection upfront and explicit validation gates: "Do NOT proceed without knowing what data exists…", "Must produce a one-liner", "Gate: User confirms the proposal". Knowledge Routing Step 3 provides an error-recovery path (declare metric unavailable, propose nearest alternative), and the Edge Cases table acts as a checklist — matching the anchor with explicit validation, feedback loops, and checklists.

5 / 5

Progressive Disclosure

Good structure with clearly signaled, one-level-deep references ("Read references/chart-selection-guide.md", "Load references/viz-spec-template.md"), and chart-selection knowledge is properly split out of SKILL.md. However, the body cites "references/data-viz-conventions.md" which does not exist in references/, while references/metrics-map.md exists but is never cited — broken and orphaned bundle files are minor organization gaps, so this is a 4 rather than a 5.

4 / 5

Total

18

/

20

Passed

Description

96%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: explicit 'Use when' clause, five concrete capabilities, and comprehensive bilingual trigger terms including colloquial user phrasings. The only weakness is that several trigger terms ('chart', 'analytics', 'dashboard') are generic enough to compete with other visualization-oriented skills.

DimensionReasoningScore

Specificity

Lists five concrete actions — "Creates bar/line charts, renders data tables, aggregates KPI metrics, builds filterable dashboard layouts, and generates HTML previews" — plus a scoped domain ("data-heavy screens, analytics dashboards, metric visualizations, or inline charts for Copilot"), matching the comprehensive-coverage anchor. It is not a 4 because no meaningful action in the skill's scope is left uncovered.

5 / 5

Completeness

Explicitly answers both questions: what ("Creates bar/line charts, renders data tables, aggregates KPI metrics…") and when ("Use when building data-heavy screens, analytics dashboards, metric visualizations, or inline charts for Copilot"). This matches the anchor for clearly and explicitly answering both with concrete trigger phrases; not a 4 because the 'when' is fully explicit, not merely present.

5 / 5

Trigger Term Quality

Triggers include natural terms in two languages — 'dashboard', 'métricas', 'gráfico', 'chart', 'visualización', 'analytics', 'KPI', 'reporte' — plus conversational phrases a user would actually say ('muestra los datos', 'cómo van los números'), matching the comprehensive synonym coverage anchor. Not a 4: the bilingual synonym and colloquial-phrase coverage leaves no natural term obviously missing.

5 / 5

Distinctiveness Conflict Risk

Has a clear niche (chart/dashboard design with HTML previews, Copilot inline mode), but generic triggers like 'chart', 'analytics', 'dashboard', and 'KPI' overlap with other data-visualization or general-dataviz skills that a user might intend instead. Mostly distinct with minor overlap risk against closely related viz skills — anchor 4 — rather than a 5 with minimal conflict risk.

4 / 5

Total

19

/

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/ap_sales_agent
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.