Content
85%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.
A well-structured procedural skill: clear sequencing with real validation and feedback loops, condition-signaled references that match the actual bundle, and concrete API-level guidance. The two modest gaps are slight redundancy across steps and a smoke test that is described rather than provided as runnable code.
Suggestions
Consolidate the repeated "preference, not guarantee" guidance (Step 2.8 vs Step 4.4) and the repeated compatibility.md signals into one location each.
Add a short runnable smoke-test snippet (or point to a concrete example in references/examples.md) so the Step 5 validation path is copy-paste executable.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is efficient, imperative, and free of basic-concept padding, but minor trimming is possible: Step 2 items 8 and Step 4 item 4 both restate "preference, not guarantee", and `references/compatibility.md` is re-signaled in Step 2, Step 5, and Error Handling. This fits "Efficient; minor instances of over-explanation that could be trimmed" better than the every-token-earns-its-place anchor. | 4 / 5 |
Actionability | Concrete commands (`node scripts/find-webnn-targets.mjs .`), exact API call ordering ("`context.writeTensor()`, `context.dispatch()`, and `await context.readTensor()` in that order"), and an adaptable template (`assets/webnn-runtime.template.ts`) make most guidance executable. It falls just short of fully copy-paste ready because the Step 5 smoke test is described ("creates a context, builds a trivial graph, writes inputs, dispatches, and reads outputs") rather than given as runnable code, and no code snippet appears inline — the fully-executable anchor expects specific examples covering common cases. | 4 / 5 |
Workflow Clarity | Five clearly sequenced procedures culminate in a dedicated validation step (Step 5: re-run the discovery script, verify detection, smoke test the graph path, test fallback, run build/typecheck/tests), with explicit feedback loops in Error Handling (retry via approved fallback, check references before rewriting, recreate context on `context.lost`) and stop-and-ask checkpoints in Step 1. This matches the explicit-validation-with-recovery anchor. | 5 / 5 |
Progressive Disclosure | The body is a procedural overview that signals each one-level-deep bundle file by condition — "Read `references/webnn-reference.md` before writing code", `examples.md` "when choosing between a direct WebNN graph flow and an adapter", `compatibility.md` for support questions, `troubleshooting.md` on failures, plus a script and a template asset, all of which exist and none of which reference further bundle files. This matches the clear-overview, well-signaled-references anchor. | 5 / 5 |
Total | 18 / 20 Passed |