Content
100%Weight 40%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
An exemplary instruction-only skill body: it assumes Claude's competence, gives fully concrete tool calls and parameters, sequences the work with explicit error-recovery checkpoints, and stays within a single well-organized file that matches its narrow scope. No weaknesses found against any anchor.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~49-line body is lean throughout: it never explains concepts Claude already knows (no 'what is a PDF' padding) and every sentence carries tool-specific guidance such as 'retrieval is lexical plus semantic, not reasoning' and 'topK (8 is a good start)'. Each token earns its place; nothing could be cut without losing actionable information. | 5 / 5 |
Actionability | Fully executable instruction-only guidance: exact tool names (`autorag.search`, `autorag.datasources.list`, `autorag.search.files`, `autorag.evidence`), concrete parameters (`query`, `topK`, `datasourceIds`, `local: true`, `sessionId`, `strict: true`), and specific recipes like 'search again with two or three differently worded queries' and routing rules per question type. Per the rubric's scoring notes, absence of code in an instruction-only skill is not penalized when the guidance is this concrete. | 5 / 5 |
Workflow Clarity | A clearly sequenced six-step workflow with explicit validation checkpoints and feedback loops: 'If a search returns `index-not-ready`, tell the user... and stop', 'If the answer is not there, search again with two or three differently worded queries', and a dedicated 'Reading the result' section mapping each diagnostic (stale, unsearched, datasource-*, embedding-unavailable) to a specific response. The skill is read-only, so the destructive/batch cap does not apply. | 5 / 5 |
Progressive Disclosure | A single-file skill under 50 lines with no bundle files (references/, scripts/, assets/ are absent) and no need for external references; per the rubric guideline, this can score 5 with well-organized sections. The intro, Workflow, Reading the result, and Safety sections are clearly delimited and easy to navigate. | 5 / 5 |
Total | 20 / 20 Passed |