Content
71%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, actionable, and concise workflow skill whose steps, commands, and output template are concrete and executable. Its main weaknesses are the missing reference.md bundle file it depends on and the absence of fallback/validation guidance for the runtime guide fetch.
Suggestions
Add reference.md to the bundle (or inline its key facts, or remove the pointer) — the body leans on it for morph driver behavior, large-table guidance, and empty-table rules, but the file does not exist.
Add a fallback for Step 1 in case the WebFetch of the official migration guide fails (e.g. proceed with reference.md rules only, noting the gap in the report).
De-duplicate Step 3's attention list against the Safety Analysis table in the template, keeping the rationale in only one place.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and directive with no padding or explanations of known concepts; the only trimmable redundancy is that Step 3's bullet list ('Whether CONCURRENTLY is used...') repeats checks already encoded in the report template table. | 4 / 5 |
Actionability | Gives exact glob patterns, concrete git diff commands, a complete fill-in report template with exact status values, and a save path. Minor gaps: the referenced reference.md does not exist in the bundle, and Step 1 depends entirely on a live WebFetch with no fallback. | 4 / 5 |
Workflow Clarity | A clear 5-step sequence with error-recovery branches ('If nothing is found, ask the user', 'If the down migration is missing, flag it') and a checklist-style report template; the gap is no guidance for what to do if the official guide fetch fails. | 4 / 5 |
Progressive Disclosure | The single-file body is well-sectioned per step and the external guide link is clearly signaled, but the one bundle reference, reference.md, is dangling — the file is absent from the bundle, so navigation breaks at the exact point detailed knowledge is needed. | 3 / 5 |
Total | 15 / 20 Passed |