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.
A genuinely lean, well-structured body with executable command examples and a complete input schema, undermined by references to scripts and another SKILL.md that are not part of the skill's bundle and would not resolve. The skill reads as a pointer stub for an external skill rather than a self-contained bundle.
Suggestions
Fix script paths to be bundle-relative (e.g., `scripts/project_health_dashboard.py`) and actually ship the two scripts in the skill's scripts/ directory.
Remove the "Skill Reference" section pointing to `project-management/skills/senior-pm/SKILL.md`, or replace it with resolvable in-bundle reference files (e.g., references/output-format.md).
State explicitly how the command maps to execution (e.g., 'Run the corresponding script with the provided data file'), including what to do if the input JSON fails validation.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~45-line body is lean with zero padding: a one-line summary, two usage lines, one complete input schema, three example commands, and a compact script listing. No concepts Claude already knows are explained; every section earns its tokens, matching the 5 anchor 'Lean and efficient; assumes Claude's competence'. | 5 / 5 |
Actionability | Concrete, copy-paste-ready commands ("/project-health dashboard portfolio-q2.json --format json") and a fully specified input JSON schema give strong executability. It falls short of 5 because the two scripts are referenced by repo-style paths ("project-management/skills/senior-pm/scripts/...") that do not exist in the skill's bundle, and no fallback or output description is provided. | 4 / 5 |
Workflow Clarity | For this simple single-action skill the invocation is essentially unambiguous — pick dashboard or risk, supply a data file matching the documented schema, optionally set --format. It gets 4 rather than 5 because the mapping from the slash command to actually running the listed script is only implied (the body never states 'run the corresponding script'), and no guidance exists for handling malformed input. | 4 / 5 |
Progressive Disclosure | Sections are well organized (Usage, Input Format, Examples, Scripts, Skill Reference), but the referenced detail files are broken: no scripts/, references/, or assets/ directories exist in the bundle, and both script paths plus the "Skill Reference" point to an external location (project-management/skills/senior-pm/...) that is unreachable. The structure exists but the disclosure chain dead-ends, fitting the 3 anchor 'Some structure but could be better organized; references present but not clearly signaled' more than the 4 anchor whose references resolve. | 3 / 5 |
Total | 16 / 20 Passed |