Content
92%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 skill body: concise tables, an executable command, a clear workflow, and an error-handling table that doubles as recovery feedback loops, with detail properly pushed to real one-level-deep reference files. The single gap is the absence of a worked invocation example with realistic values and expected output in the body itself.
Suggestions
Add one worked example in the Workflow section with realistic values (e.g. a managedCluster portal URL and query 'image cleaner') plus a line of expected output, so the common case is fully covered without opening references/README.md.
Briefly state what the script's printed output looks like (a list of portal deep links rooted at https://portal.azure.com) so Claude knows how to interpret and present the results to the user.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and table-driven with zero padding: a Quick Reference table, a three-step workflow, and an error table. It assumes Claude's competence, explains no general concepts, and every token earns its place, matching the anchor-5 'lean and efficient' profile. | 5 / 5 |
Actionability | The workflow gives a copy-paste-ready command ('references/Invoke-PortalSearchNav.ps1 -ResourceUrl '<link>' -Query '<query>'') plus a concrete install command in the error table. It falls short of anchor 5 because the body itself lacks a worked example with realistic argument values or a sample of the script's output (that example lives only in references/README.md), leaving a minor gap for the most common case. | 4 / 5 |
Workflow Clarity | The sequence is unambiguous (collect resource link and query, run the script, read the emitted portal links), and the Error Handling table supplies explicit error-to-fix feedback loops (401 → re-run selecting the correct tenant; no window handle → re-run with -UseDeviceAuthentication; empty results → retry a different term). The operation is read-only link building, so the destructive/batch validation cap does not apply. | 5 / 5 |
Progressive Disclosure | The ~45-line body is a clean overview that delegates detail to well-signaled, one-level-deep references (references/README.md for full parameter/API details, plus the script and resource-types.json), all of which exist in the bundle. Navigation via the Quick Reference table is easy, matching the anchor-5 structure. | 5 / 5 |
Total | 19 / 20 Passed |