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 excellent instruction-only skill body: lean decision-rule prose, a clearly sequenced diagnose-then-verify workflow with explicit validation and unverified-gap reporting, and a clean overview-to-references split that matches the actual bundle. The single gap is that the body names tools and decisions but defers all literal commands to the reference files.
Suggestions
Include one or two literal commands in the body (e.g. `flutter attach --flavor <flavor>` or `flutter run --profile`) so the primary flow is executable without loading a reference.
Consider a compact numbered restatement of the four-phase flow (reproduce → localize first incorrect transition → minimal fix → re-run as evidence) to make the sequence scannable at a glance.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body never explains concepts Claude already knows (no "what is Flutter" or "how hot reload works" padding) and every sentence encodes a constraint or decision rule, e.g. "Do not infer a root cause from the last stack frame, a screenshot, or a downstream assertion alone". It assumes competence throughout, matching the lean anchor rather than the minor-over-explanation anchor 4. | 5 / 5 |
Actionability | Guidance is specific and executable at the decision level — "perform a full rebuild and clean-process launch on every affected supported target", "Change one relevant variable at a time", "Use Dart and Flutter MCP capabilities... otherwise rely on DevTools and CLI output" — but the body contains no copy-paste commands (e.g. `flutter attach`, `flutter run --profile`); concrete commands live only in the reference files. This sits between anchor 3 (missing key details) and anchor 5 (copy-paste ready), so 4. | 4 / 5 |
Workflow Clarity | The opening line states the sequence ("Turn a reported symptom into a repeatable failure, identify the first incorrect state... apply the smallest supported fix, and repeat the same flow as evidence") and the sections follow it, with explicit checkpoints: record trigger/expected/actual, "require the first incorrect transition at every implicated boundary", one-variable-at-a-time experiments, and a Verification section that repeats the original flow and states "anything not reproduced or verified". Error-recovery loops and gap reporting are explicit, matching anchor 5. | 5 / 5 |
Progressive Disclosure | The body is a concise overview with two well-signaled, conditionally-loaded references — "Read [reproduction and attachment](references/reproduction-and-attachment.md) when..." and "Read [DevTools diagnosis](references/devtools-diagnosis.md) when..." — both of which exist in the bundle, are one level deep, and contain the appropriately-split detail (the body's boundaries/verification summary vs. the references' procedures). No nesting beyond one level, so anchor 5 rather than the minor-gaps anchor 4. | 5 / 5 |
Total | 19 / 20 Passed |