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 lean, instruction-only skill: a short motivating intro followed by an unambiguous four-step discovery workflow with concrete paths, a worked example, and fallback resolution. No padding, no gaps, and no unnecessary external file structure.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~25-line body contains zero padding and no explanations of concepts Claude already knows — the brief framing sentence ('tribal knowledge (architecture, data flows, type mappings, pitfalls)') is the only context and it directly motivates the workflow. Every token earns its place, matching the 'lean and efficient' anchor. | 5 / 5 |
Actionability | Each step is fully executable: exact directory names ('.github/skills/'), a concrete path-to-package example ('sdk/search/Azure.Search.Documents/src/SearchClient.cs' → 'sdk/search/Azure.Search.Documents/'), and a CODEOWNERS fallback when only a package name is known. Per the rubric's instruction-skill note, absence of code is not penalized when guidance is this concrete. | 5 / 5 |
Workflow Clarity | The four steps are clearly sequenced with an explicit decision branch (skill directory exists → read all SKILL.md and references/; not exists → 'proceed normally'). This is a read-only discovery operation, so no validation/feedback loops are required, and the sequence with its branch handling is unambiguous — matching the simple-skill allowance for a 5. | 5 / 5 |
Progressive Disclosure | The skill is under 50 lines with no bundle files (no references/, scripts/, or assets/ exist) and no need for external references; the two well-organized sections (intro + 'How to Discover Package Skills') satisfy the rubric's simple-skill exception for a top score. | 5 / 5 |
Total | 20 / 20 Passed |