CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

rill-development

Overview of how to develop a Rill project

1.13x
Quality

69%

Does it follow best practices?

Impact

100%

1.13x

1 of 3 eval scenarios. Add 2 more for a full score.

SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

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

Quality

Content

70%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 body is a well-organized, highly actionable overview of the Rill platform with an excellent validated workflow, but it is held back by repeated guidance (the duplicate-explore warning appears three times) and references to resource-specific instruction files that are neither named nor bundled. Adding a small YAML example per key resource type and concrete paths for the deferred documentation would lift it further.

Suggestions

Consolidate the duplicate-explore-dashboard guidance into one authoritative location (the Explores section or the pitfalls list) and reference it from the other spots, trimming roughly a paragraph of repetition.

Make deferred documentation resolvable: name the actual files/paths for the resource-specific instructions (or bundle them under references/) instead of vague pointers like "the metrics view instructions".

Add one minimal example YAML snippet for a model and a metrics view so the most common edits are copy-paste ready.

DimensionReasoningScore

Conciseness

The body is mostly platform-specific knowledge Claude would not already have, but it could be tightened: the duplicate-explore-dashboard warning appears three times ("Do NOT also create a stand-alone `type: explore` file", "Do not create a separate `type: explore` file", "Creating a duplicate explore dashboard"), and the expense/caution guidance for models is stated twice. This matches anchor 3 (mostly efficient, some unnecessary explanation) better than 4 given the duplication across a ~300-line body.

3 / 5

Actionability

Guidance is concrete throughout: named tools with usage constraints ("`query_sql` for running SQL ... use `SELECT` statements with `LIMIT` clauses and low timeouts"), specific properties (`olap_connector:`, `managed: true`, `mode: read`, `timeseries:`), a CLI fallback (`rill validate`), and concrete limits ("up to 10 dimensions and up to 5 measures"). It falls short of anchor 5 because no example YAML/SQL snippets for any resource type are included.

4 / 5

Workflow Clarity

The "Recommended workflow" gives a numbered 8-step sequence with pre-flight checks (write access, data access, OLAP mode), explicit per-stage validation ("At each stage, check if there is a parse or reconcile error"), an iterate-until-fixed feedback loop, and `wait_until_idle` to block on reconciliation. This matches anchor 5 (clear sequence, explicit validation steps, feedback loops for error recovery); it exceeds 4 because checkpoints are woven through the process rather than only at the end.

5 / 5

Progressive Disclosure

The body is well-sectioned and correctly defers detail ("The descriptions are high-level; you can find detailed descriptions and examples in the separate resource-specific instruction files"), but those references are not clearly signaled: they name no files or paths ("the metrics view instructions", "the instructions for model development", the `rill-metrics-view` skill) and no references/ bundle exists to back them. This matches anchor 3 (references present but not clearly signaled) rather than 4, where references would be mostly concrete and resolvable.

3 / 5

Total

15

/

20

Passed

Description

52%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 clear, distinctive niche (Rill development) but is far too terse: it names no concrete actions, includes no trigger phrases or 'use when' guidance, and relies entirely on the reader already knowing what Rill is. It functions as a label rather than a routing signal.

Suggestions

Add 2-3 concrete capabilities to the description, e.g. "Define connectors, models, and metrics views; build explore and canvas dashboards on OLAP data".

Add an explicit 'Use when' clause, e.g. "Use when developing, debugging, or extending a Rill project, or when the user mentions Rill, dashboards, or metrics views".

Include natural trigger terms users would say — Rill, dashboard, metrics view, model, connector, BI — to improve both trigger quality and completeness.

DimensionReasoningScore

Specificity

"Overview of how to develop a Rill project" names the domain but lists no concrete actions (no models, dashboards, connectors, or metrics views are mentioned). It sits at anchor 2 rather than 3 because not even one or two concrete actions are named, and above 1 because the domain is specifically identified.

2 / 5

Completeness

The description gives a 'what' (developing a Rill project) but it is high-level and there is no 'when to use' clause or equivalent trigger guidance, which caps completeness at 3. It stays at 3 rather than dropping to 2 because the activity and domain are at least stated, if briefly.

3 / 5

Trigger Term Quality

"Rill" and "develop" are relevant natural keywords, but common phrases a user would actually say — dashboard, BI, metrics, connector, model — are absent. This matches anchor 3 (some relevant keywords, missing variations/synonyms) better than 4, since keyword coverage is thin.

3 / 5

Distinctiveness Conflict Risk

"Rill" is a distinctive niche platform name, so any query mentioning Rill maps unambiguously to this skill with minimal conflict risk, matching anchor 5. It is not 4 because the overlap risk with other skills is negligible, not merely minor.

5 / 5

Total

13

/

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