Content
77%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-constructed operational skill body: lean, command-driven, with explicitly validated workflows and concrete numeric decision rules. Its main defects are executable-but-dangling script references (the entire scripts/, references/, and assets/ bundle is missing) and some trimmable meta-content.
Suggestions
Ship the referenced bundle files (scripts/velocity_analyzer.py, sprint_health_scorer.py, retrospective_analyzer.py, references/team-dynamics-framework.md, references/velocity-forecasting-guide.md, and the four assets/ files) — every path cited in the body currently resolves to nothing, which breaks both navigation and execution.
Trim meta-content: the opening self-description paragraph duplicates the frontmatter description, and the Table of Contents, "Related Skills" section, and closing italic pointer line add ~20 lines with little operational value for a 200-line document.
Make the script invocations path-consistent (some use scripts/velocity_analyzer.py, others bare velocity_analyzer.py) and specify the working directory so commands are truly copy-paste ready.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and operational — command blocks, weighted-dimension tables, metric targets, and numbered workflows — and does not re-explain concepts Claude already knows (no "what is Scrum" padding), matching the score-4 anchor of efficient with minor trimmable content. It falls short of score 5 because the opening self-description paragraph, the 7-line Table of Contents, the "Related Skills" section, and the closing italic pointer line are meta-content that could be trimmed or merged. | 4 / 5 |
Actionability | Guidance is highly concrete: exact bash invocations per script, a JSON input schema, expected-output values ("velocity avg 20.2 pts, CV 12.7%, health score 78.3/100, action-item completion 46.7%"), and numeric decision rules ("70% confidence interval as the recommended commitment ceiling", "≤3 if completion rate <60%"). It is not score 5 because the commands are not fully executable as delivered — the cited script files (scripts/velocity_analyzer.py etc.) are absent from the bundle, and some invocations drop the scripts/ path prefix. It is well above score 3 since everything written is specific and runnable in principle. | 4 / 5 |
Workflow Clarity | The Sprint Execution and Team Development workflows are clearly sequenced with explicit validation checkpoints and escalation loops: "If fewer than 3 sprints are present... stop and prompt the user", "If a blocker is unresolved after 2 days, escalate proactively", "If scores plateau or regress for 2 consecutive sprints, escalate intervention strategy", plus per-script data requirements. This matches the score-5 anchor of clear sequences with explicit validation and feedback loops; there are no missing checkpoints. | 5 / 5 |
Progressive Disclosure | The SKILL.md is structured as a proper overview with clearly signaled one-level-deep references ("details in references/team-dynamics-framework.md", "See assets/sample_sprint_data.json"), which alone would rate 4-5. However, none of the referenced files exist in the bundle — scripts/, references/, and assets/ are absent entirely — so every pointer dangles and the disclosure structure does not actually function. Score 3 reflects good on-page organization undermined by a broken referenced structure; not score 2 because the SKILL.md body itself still contains substantial inline usable content rather than deferring everything to the missing files. | 3 / 5 |
Total | 16 / 20 Passed |