Content
77%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, actionable guide with a strong validated workflow for Rill development, but it is a single monolithic file whose references to per-resource instruction files and sibling skills point to bundle files that do not exist.
Suggestions
Provide the referenced resource-specific instruction files (e.g. model, metrics-view, connector guides) or remove the dangling "see ... instructions" references so navigation is one level deep and resolvable.
Split the per-resource-type details into separate reference files and keep SKILL.md a concise overview pointing to them, reducing the monolithic length.
Tighten the introductory "Introduction to Rill" and OLAP sections, which lean on conceptual explanation, to improve token efficiency.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~280-line body is mostly Rill-specific knowledge Claude would not already know, so most tokens earn their place, but it is a long monolithic document with sections that could be tightened or split out. | 2 / 3 |
Actionability | It provides concrete executable guidance — specific tools (project_status, query_sql, list_tables), CLI commands (rill validate), exact YAML properties (olap_connector:, managed: true, mode: read), and a real project file listing — meeting the actionable standard for an instruction-only skill. | 3 / 3 |
Workflow Clarity | The 8-step Recommended workflow is clearly sequenced with an explicit feedback loop — step 8 checks for parse/reconcile errors at each stage and iterates until fixed — plus validation via wait_until_idle and rill validate. | 3 / 3 |
Progressive Disclosure | The body is well-sectioned but monolithic, and it repeatedly references separate resource-specific instruction files and skills (e.g. "instructions for model development", the rill-metrics-view skill) that are not present in the bundle, leaving navigation dangling. | 2 / 3 |
Total | 10 / 12 Passed |