Content
82%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: dense with unguessable protocol specifics (exact tools, fields, labels, and ordering) and free of fluff, with a clearly sequenced pre-generation workflow and a deterministic reuse ladder. Remaining gaps are the lack of concrete payload examples and of any error-recovery loop, plus a few protocol details that could move to a reference file.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Every sentence carries app-specific protocol knowledge Claude cannot know — state-record field names ("contextMode, pinnedPackId, and selectedContextId"), exact tool names, and payload contracts like "version.nativeCode.content is exact only when it is a string" — with no padding or explanation of concepts Claude already knows. | 5 / 5 |
Actionability | Exact tool and action names ("get-context-item", "clone-creative-context-deck", "creative-context-a2a"), exact field paths, required labels ("reused, adapted, reference-conditioned, or generated"), and an exact ordering rule make the guidance directly executable; the minor gap is the absence of any concrete example payload, state record, or A2A message shape. | 4 / 5 |
Workflow Clarity | The five-step numbered pre-generation sequence has explicit checkpoints (mode "off" → do not retrieve; snapshot versions before writing) and the reuse ladder stops at the first satisfying rung, with edge-case handling for hierarchical and oversized payloads; it falls short of a 5 because there is no validate-and-recover loop for failure cases such as an inaccessible pinned pack. | 4 / 5 |
Progressive Disclosure | The body is one well-sectioned file with no external references and no bundle files exist, so there is no nesting problem; however, dense protocol detail such as the isolated A2A receiver rule and the native-code retrieval contract could be split into a reference file, and at ~85 lines the under-50-line exception for a 5 does not apply. | 4 / 5 |
Total | 17 / 20 Passed |