Content
86%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 exemplar API-usage skill: executable, annotated code for every common case, a decision table for imperative refresh, a sequenced debugging approach, and a clean one-level-deep reference bundle that was verified against the actual file listing. Only minor trims are available (one generic React bullet and the padded closing directive), keeping it just short of maximum conciseness.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Code-first and dense: every section is annotated snippets or a decision table, with no explanation of React or library basics, and code comments carry non-obvious info (the exact HTTP request each call makes). Not 5: a few tokens don't earn their place — "Prefer smaller React components that do one thing" is generic React advice, and the closing bolded "ALWAYS follow these patterns..." directive is padded; not 3: beyond those minor spots there is no unnecessary explanation. | 4 / 5 |
Actionability | Copy-paste-ready call signatures cover the common cases: reads (useSuspense/useCache/useQuery/useDLE/useLive), conditional fetch via null params, parallel loading with useFetch + React.use(), mutations (update/partialUpdate/push/unshift/delete/pagination), forms (useLoading), debounce, AsyncBoundary, Controller refresh calls, and Query derivation. Missing resource definitions are explicitly delegated ("For API definitions (like TodoResource), apply the skill 'data-client-rest'"), so examples are complete for the skill's scope. Not 4: coverage of common cases is comprehensive with exact parameters and returns. | 5 / 5 |
Workflow Clarity | Where workflows exist they are clearly sequenced: debugging says to "inspect the page's store before reading code for the cause" via __DC__.controller/__DC__.actions, then points to a symptom-mapped guide; the refresh table gives an explicit decision sequence (have-value → set, one endpoint → fetch, all args → expireAll, hide-while-refetching → invalidate). Not 5: there are no explicit validation checkpoints or feedback loops; not 3: sequencing and decision points are present and unambiguous, and no destructive/batch workflow is prescribed that would require validation. | 4 / 5 |
Progressive Disclosure | The body is an overview of patterns while all API detail lives one level deep in references/ (27 files, every path cited in the body verified to exist), each with a one-line description in the References section; inline links like [AsyncBoundary](references/AsyncBoundary.md) appear in context, and browser-tool files instruct "read only yours". Cross-links inside reference files are lateral sibling navigation, not nested chains. Not 4: the split is appropriate throughout — patterns in SKILL.md, reference detail in the bundle, with clear navigation. | 5 / 5 |
Total | 18 / 20 Passed |