Content
78%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.
The body is a well-sequenced, appropriately concise workflow with real validation around a destructive batch operation. The main gaps are the missing concrete command for the central reference-search step and the absence of an explicit error-recovery loop after deletion.
Suggestions
Provide a concrete reference-search command, e.g., 'rg -l "<asset-name>" src/ plugin.xml' or a loop that greps each asset filename against source and plugin.xml.
Add an explicit recovery step: if verifyPlugin or the plugin load check fails after deletion, restore the removed assets (e.g., via git checkout) before iterating.
Remove the duplication between the opening task sentence and the '## Objective' section to tighten token usage.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean with concrete gradle commands and no explanations of concepts Claude already knows. However, the opening line 'You are tasked with reducing plugin size by removing unused icons, images, and resources' is duplicated verbatim by the '## Objective' section, a minor instance of padding that keeps it from anchor 5. | 4 / 5 |
Actionability | Most steps are executable — specific commands ('./gradlew test', 'verifyPlugin', 'buildPlugin', 'testClasses') and paths ('resources/icons', 'plugin.xml') — but the core operation 'Check if each asset is referenced in code or plugin.xml' provides no concrete search command (e.g., a grep/ripgrep invocation). This is a minor gap consistent with anchor 4 rather than fully copy-paste-ready anchor 5. | 4 / 5 |
Workflow Clarity | A clear six-step sequence (baseline, scan, search, remove, verify, report) with validation checkpoints on both sides of the destructive deletion, so the destructive-operation cap does not apply. It stops short of anchor 5 because there is no explicit error-recovery loop, e.g., what to do if verifyPlugin fails after assets are deleted. | 4 / 5 |
Progressive Disclosure | The skill is under 50 lines, single-purpose, needs no external references (none exist in the bundle), and is well-organized into an Objective plus six numbered workflow sections. Per the simple-skills scoring note, this earns a 5 on organization alone. | 5 / 5 |
Total | 17 / 20 Passed |