Content
42%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The skill covers a useful meta-task (reviewing other skills) with a clear three-mode structure and helpful concrete examples for common issues and PR etiquette. However, it suffers significantly from referencing multiple supporting files that don't exist in the bundle, undermining both actionability and progressive disclosure. The workflows would benefit from explicit validation steps and error handling rather than simple checkbox lists.
Suggestions
Include the referenced bundle files (evaluation_checklist.md, pr_template.md, marketplace_template.json) or inline their essential content to make the skill self-contained and actionable.
Add explicit validation and error recovery steps to the External Review and Auto-PR workflows (e.g., what to do if cloning fails, how to verify improvements before PR submission).
Remove or condense the setup section — the auto-install sequence references a specific plugin ecosystem that may not be accessible, and the find commands are fragile. Consider making the skill work without this dependency.
Tighten the PR Guidelines section by combining the tone examples and required sections into a more compact format, or move them entirely to the referenced pr_template.md.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is moderately efficient but includes some unnecessary structure like the setup section with bash commands for installing a dependency that may not exist, and the checklist table format adds bulk. Some sections like PR guidelines and tone examples, while useful, could be tighter. | 2 / 3 |
Actionability | Provides concrete bash commands and YAML examples for common fixes, but several key workflows rely on references to files that don't exist in the bundle (e.g., references/evaluation_checklist.md, references/pr_template.md). The setup commands reference a specific plugin ecosystem that may not be real or accessible, reducing practical executability. | 2 / 3 |
Workflow Clarity | Three modes are clearly identified with checklists, but the workflows lack explicit validation checkpoints and error recovery steps. The External Review and Auto-PR workflows are presented as simple checkbox lists without concrete commands or feedback loops (e.g., what to do if the fork fails, if validation finds issues, etc.). | 2 / 3 |
Progressive Disclosure | The skill references four bundle files (references/evaluation_checklist.md, references/pr_template.md, references/marketplace_template.json, and an external URL) but none of these files exist in the bundle. This creates broken references and a hollow progressive disclosure structure that promises depth but delivers nothing. | 1 / 3 |
Total | 7 / 12 Passed |