Content
72%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 concise, well-organized single-purpose migration guide with genuinely actionable component mappings and tooling pointers. Its main gaps are the absence of any validation/verification step in the migration workflow and the lack of a copy-paste-ready codemod command.
Suggestions
Add a validation step after running the codemod, e.g., "Run build/tests; if component errors appear, check the migration guide for that component and re-run the codemod" — this addresses the workflow_clarity cap.
Include the exact command for the automated tool (e.g., `npx @ant-design/codemod-v5 src/`) instead of just naming it, making the guidance copy-paste ready for actionability.
Merge the Notes section into the Instructions where it duplicates them (Less/CSS-in-JS, deprecated APIs) to remove redundancy and tighten conciseness.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean with no padding of concepts Claude already knows, but the Notes section partially repeats the Instructions (Less/CSS-in-JS and deprecated-API points), which could be trimmed for a fully token-efficient 5. | 4 / 5 |
Actionability | Concrete mappings ("BackTop → FloatButton.BackTop", "Comment → use @ant-design/compatible"), a named tool, and specific URLs make the guidance mostly executable; it falls short of 5 because no exact command for running the codemod is given and "check migration guide for full list" defers key details. | 4 / 5 |
Workflow Clarity | Steps 1-4 are listed in a sensible sequence, but there are no validation checkpoints (e.g., run build/tests after applying the codemod); since a version migration touches many files, the missing feedback loop caps this at 3 rather than 4. | 3 / 5 |
Progressive Disclosure | The skill is under 50 lines with no bundle files and no need for external references; the well-organized When to Use / Instructions / Notes sections fully satisfy the simple-skill exception for a top score. | 5 / 5 |
Total | 16 / 20 Passed |