Content
85%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 an exemplar of brevity — compact, well-sectioned, and concrete, with a complete input format and usage examples. Its weaknesses are almost entirely structural: the skill delegates all actual analysis work to a script path that does not exist in this bundle, and the dangling 'Skill Reference' link adds confusion rather than navigation value. Fixing or inlining the reference targets would resolve the main issues.
Suggestions
Fix the script reference to a bundle-relative path (e.g., scripts/retrospective_analyzer.py) and include the script in the bundle, or inline the analysis guidance so the skill works standalone.
Remove or clarify the 'Skill Reference' section pointing to another SKILL.md at an external path — as written it is a dangling link that adds no navigation value.
Add brief guidance on interpreting the output or handling malformed input files so the skill remains actionable even if the referenced script is unavailable.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and efficient — every section (Usage, Input Format, Examples, Scripts) carries concrete information, with no padding or explanations of concepts Claude already knows. It fully matches the anchor for a body where every token earns its place. | 5 / 5 |
Actionability | Concrete commands with full syntax, a complete executable input JSON example, and specific example invocations make the guidance mostly executable. The gap keeping it below anchor 5 is that the analyzer script is referenced by an external path not present in this bundle, and there is no inline guidance for what the analysis should produce or how to handle malformed input. | 4 / 5 |
Workflow Clarity | This is a simple, single-purpose skill: the single action — run the analyzer on a retro JSON file, with optional --format text|json — is unambiguous, with input shape and flags fully specified. Per the simple-skill exception, a single unambiguous action warrants a 5; it involves no destructive or batch operations that would cap the score. | 5 / 5 |
Progressive Disclosure | Sections are well-organized for a short skill, but the two file references point outside the bundle to non-existent local paths ("project-management/skills/scrum-master/scripts/retrospective_analyzer.py" and "project-management/skills/scrum-master/SKILL.md") and are not clearly signaled as external. This matches the anchor for references present but not clearly signaled, rather than anchor 4's well-signaled, appropriately placed references. | 3 / 5 |
Total | 17 / 20 Passed |