Content
77%Scale 1-3Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a well-structured, highly actionable skill that provides Claude with everything needed to display project status, including exact file paths, parsing logic, output templates, and error handling. Its main weakness is length—the extensive inline output format templates and boilerplate sections make it less token-efficient than it could be. The output format specifications, while thorough, could be split into a referenced file to improve progressive disclosure.
Suggestions
Move the detailed output format templates (full status, single track status, error states) into a separate referenced file like 'resources/status-templates.md' to reduce the main skill's token footprint.
Remove the generic 'Use this skill when' / 'Do not use this skill when' sections—they add no value beyond what the skill title and description already convey.
Trim the initial Instructions section which contains vague generic advice ('Clarify goals, constraints, and required inputs') that doesn't apply to a status display command.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is quite long (~200+ lines) with extensive output format templates that are largely illustrative. The 'Use this skill when' / 'Do not use this skill when' sections are generic boilerplate. However, the detailed output formats and calculation logic do serve as concrete specifications, so it's not purely verbose—just could be tightened significantly. | 2 / 3 |
Actionability | The skill provides highly specific, concrete guidance: exact file paths to read, exact regex patterns for task counting, exact output formats with examples, calculation logic for progress bars, and clear error state handling. Claude would know exactly what to do at every step. | 3 / 3 |
Workflow Clarity | The workflow is clearly sequenced: pre-flight checks → data collection (4 numbered steps) → output formatting. Pre-flight checks include validation (file existence) with error recovery paths. The multi-step data collection process is well-ordered with explicit sources for each piece of data. | 3 / 3 |
Progressive Disclosure | The skill is monolithic—all output format templates, error states, calculation logic, quick mode, and JSON output are inline rather than split into referenced files. There's one reference to 'resources/implementation-playbook.md' but the bulk of content that could be in separate files (output templates, error templates) is embedded directly, making this a long single document. | 2 / 3 |
Total | 10 / 12 Passed |