CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

rill-charts

How to chart a metrics view with the create_chart tool, which chart type fits which question, and the pitfalls that produce misleading charts

Quality

86%

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

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

An exemplary lean, instruction-only skill: dense with tool-specific specifics, zero padding, a clear pre-chart checklist plus an explicit recovery loop for truncated results, and clean section organization appropriate to its size. No bundle files exist and none are needed at this length.

DimensionReasoningScore

Conciseness

Every line carries tool-specific, non-obvious guidance — exact argument names (`color`, `group`, `detail`, `innerRadius`, `data.comparison_time_range`, `time_grain`) and Rill-specific behaviors (the 'Open in Rill' link, cut-value reporting). There is no padding and no explanation of concepts Claude already knows.

5 / 5

Actionability

The body maps every common question type to a specific chart type with exact channel bindings ('Waterfall Chart with the step on `x` and the signed change on `y`'), names the exact tools to call first (`get_metrics_view`, `query_metrics_view`), and gives a worked title example. This is fully executable instruction-only guidance covering the common cases.

5 / 5

Workflow Clarity

The 'Before you chart' section is a pre-flight checklist (know fields, inspect data, one question, pick grain), and there is an explicit post-hoc feedback loop: 'When the result reports that values were cut, coarsen `time_grain` or lower the `limit`s and create the chart again.' The single task is unambiguously sequenced from inspection through creation to recovery.

5 / 5

Progressive Disclosure

The skill is under 50 lines with no bundle files (references/, scripts/, assets/ are absent) and defers argument shapes to the tool description rather than duplicating them. Sections (Before you chart / Choosing a chart / Titles / Pitfalls) are well-organized and self-contained, which per the guidelines earns a 5 for a short, single-file skill.

5 / 5

Total

20

/

20

Passed

Description

66%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 concrete, domain-specific description that clearly states what the skill does, but it lacks any explicit 'when to use' trigger guidance, which both caps completeness and weakens its retrieval behavior. Adding a 'Use when...' clause with natural user phrases would lift it to the top tier.

Suggestions

Add an explicit trigger clause such as 'Use when the user asks for a chart, graph, or visualization of a metrics view, or when a create_chart call is being prepared.'

Include natural user synonyms (graph, plot, visualize, dashboard) alongside 'chart' to broaden trigger-term coverage.

Optionally name Rill in the description to further distinguish the skill from generic charting/dataviz skills.

DimensionReasoningScore

Specificity

The description names the domain and several concrete capabilities: "chart a metrics view with the create_chart tool", "which chart type fits which question", and "the pitfalls that produce misleading charts". Coverage is good but minor gaps remain (e.g., no mention of data inspection or title guidance that the body covers), fitting the 'several specific actions; minor gaps' anchor rather than the comprehensive level 5.

4 / 5

Completeness

The 'what' is clear (charting a metrics view, chart-type selection, pitfall avoidance) but there is no 'Use when...' clause or equivalent explicit trigger guidance — nothing states when to invoke this skill. Per the judging guidelines, a missing 'Use when...' clause caps completeness at 3.

3 / 5

Trigger Term Quality

Natural terms like "chart", "metrics view", and "misleading charts" are words users would plausibly say, and the tool name "create_chart" aids matching. Common synonyms such as "graph", "plot", "visualize", or "dashboard" are absent, so it falls just short of comprehensive keyword coverage.

4 / 5

Distinctiveness Conflict Risk

The tie to the "create_chart" tool and "metrics view" gives it a clear niche with low conflict risk against unrelated skills. However, generic chart-selection and 'misleading charts' advice overlaps with general data-visualization skills, so it is 'mostly distinct' rather than a clear level-5 niche.

4 / 5

Total

15

/

20

Passed

Validation

100%

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

rilldata/agent-skills

Path

skills/rill-charts/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.