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.
The body is an exemplary minimal tool-reference document: a complete parameter table with defaults, three executable JSON examples covering common usage, and brief operational notes, with zero padding. Nothing is missing for a skill of this scope, and nothing should be moved to separate files.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is a lean parameter table, three minimal JSON examples, and short notes — no explanations of concepts Claude already knows and no padding. Every token earns its place, matching the 'lean and efficient' anchor. | 5 / 5 |
Actionability | The three JSON examples are complete, copy-paste-ready invocations covering the common cases (function search, case-insensitive TODO search, contextual search), the parameter table specifies types and defaults, and the notes document the return format ('file:line_number:content'). This matches 'fully executable; copy-paste ready; specific examples cover the common cases'. | 5 / 5 |
Workflow Clarity | This is a simple, single-purpose, read-only skill with an unambiguous single action (invoke with pattern and optional filters), which the rubric's simple-skill exception allows to score 5 without a multi-step workflow. The destructive/batch cap does not apply since searching is non-destructive. | 5 / 5 |
Progressive Disclosure | The skill is under 50 lines with no need for external references, and the rubric explicitly allows a 5 in that case with well-organized sections. Sections (Parameters, Examples, Notes, Related Skills) are clearly headed, no content that belongs in separate files is inlined, and there are no bundle files or nested references to break navigation. | 5 / 5 |
Total | 20 / 20 Passed |