CtrlK
BlogDocsLog inGet started
Tessl Logo

rill-explore

Detailed instructions and examples for developing explore dashboard resources in Rill

64

1.47x
Quality

58%

Does it follow best practices?

Impact

100%

1.47x

Average score across 2 eval scenarios

SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./skills/rill-explore/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

67%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 instructional core is excellent — decision guidance is unambiguous and the YAML examples are executable and well-chosen — but the skill monolithically inlines a large JSON schema reference that inflates the always-loaded context and duplicates the annotated example. Moving the schema to a references/ file and adding a validation step would make this a strong skill.

Suggestions

Move the full JSON schema ("Reference documentation" section) to references/explore-schema.md and link to it, keeping only 2-3 key snippets inline; this fixes both the progressive-disclosure and token-bloat problems.

Add a verification step to the workflow, e.g. "After editing, run `rill start` and confirm the explore dashboard reconciles and renders with the expected dimensions and measures".

Trim duplicated property commentary (banner, defaults, time_ranges, security are explained both in the annotated example and again in the schema) so each fact appears once.

DimensionReasoningScore

Conciseness

The prose sections are lean and Rill-specific (inline-vs-standalone rules, legacy auto-emit behavior) — genuinely non-obvious information. But the ~140-line inline JSON schema duplicates much of what the annotated example already explains (banner, defaults, time_ranges, security all appear twice), which is unnecessary padding that could be trimmed. This is "mostly efficient but includes some unnecessary explanation or could be tightened", anchor 3, not anchor 4's "minor instances".

3 / 5

Actionability

Three copy-paste-ready YAML examples (inline explore, fully annotated stand-alone, minimal stand-alone) cover the common cases, and the guidance includes concrete decision rules like "do NOT create a stand-alone type: explore file... edit the explore: block in the metrics view file" and exact field-selector syntax ('*', a list, or {exclude: [...]}). Fully executable and specific — anchor 5, and clearly not anchor 4 since no key details are missing for the common paths.

5 / 5

Workflow Clarity

The decision sequence is clear and well-ordered: check for an existing inline explore first, edit the explore: block if present, only create a stand-alone file when multiple explores are needed or the user asks. However there is no validation checkpoint (e.g., verifying the dashboard reconciles or renders), which keeps it at anchor 4 ("most checkpoints present; minor validation gaps") rather than 5. The skill is not destructive/batch, so the workflow-clarity cap of 3 does not apply.

4 / 5

Progressive Disclosure

The "Reference documentation" section inlines ~140 lines of raw JSON schema that clearly belongs in a separate reference file — this is precisely anchor 2's "content that clearly belongs in separate files is inlined" (the anchor example is an inlined API reference). No bundle files exist (no references/, scripts/, or assets/ directories), so the schema cannot be reached on demand; it cannot score 3, which would require a present, if poorly signaled, reference structure.

2 / 5

Total

14

/

20

Passed

Description

48%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 identifies a specific, distinctive domain (Rill explore dashboards) but is thin as a trigger: it states a generic capability ("detailed instructions and examples for developing") without concrete actions or any "Use when" guidance. Users searching for help with a Rill dashboard would find it, but only by luck of the exact phrase.

Suggestions

Add an explicit trigger clause, e.g.: "Use when creating or editing a Rill explore dashboard, configuring exposed dimensions and measures, or when the user mentions Rill dashboards or metrics views."

Replace the generic "detailed instructions and examples for developing" with 2-3 concrete actions, e.g., "Create and configure explore dashboards in Rill: select dimensions and measures, set time ranges and defaults, restrict access."

Include natural user phrasings as trigger terms ("dashboard", "metrics view", "Rill dashboard") to broaden keyword coverage.

DimensionReasoningScore

Specificity

"Detailed instructions and examples for developing explore dashboard resources in Rill" names the domain (Rill explore dashboards) but the only action offered is the generic "developing"; "detailed instructions and examples" is filler rather than a concrete capability. It matches anchor 2 ("Names the domain but actions are minimal or generic") and falls short of anchor 3, which requires 1-2 concrete named actions like "create" or "configure dimensions and measures".

2 / 5

Completeness

The "what" is clear (instructions and examples for developing explore dashboards in Rill), but there is no "Use when..." clause or equivalent explicit trigger guidance, which the judging guidelines cap at 3. Anchor 4 requires both a "what" and a "when", and no "when" is present or even weakly implied.

3 / 5

Trigger Term Quality

"explore dashboard" and "Rill" are natural terms a user would say, but common variations and synonyms are missing — users would likely say "dashboard", "metrics view", "build/create a dashboard", or mention YAML/dashboard configuration. This is "some relevant keywords but missing common variations", anchor 3, not anchor 4's "good keyword coverage".

3 / 5

Distinctiveness Conflict Risk

The phrase "explore dashboard resources in Rill" carves out a clear niche with a distinct product-specific trigger ("Rill", "explore dashboard"), so conflict risk with unrelated skills is minimal. It is not a 5 because it could still overlap with closely related Rill skills (e.g., canvas dashboards or metrics views), which anchor 4 ("Mostly distinct; minor overlap risk with closely related skills") describes exactly.

4 / 5

Total

12

/

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