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.
The body is a highly concrete, well-sequenced reporting procedure with exact parsing rules, calculation logic, and complete output templates including error states and recovery guidance. Its weaknesses are a dangling reference to a nonexistent resources/implementation-playbook.md, a few unspecified derivation details (active-track selection, git history), and generic filler sections that pad the token budget without adding guidance.
Suggestions
Fix or remove the dangling reference to `resources/implementation-playbook.md` — the file does not exist in the bundle, breaking navigation; if detailed examples are needed, create it under references/ with a clearly signaled link.
Specify how to derive the 'Active Track' (e.g. 'the in-progress track with the most recent last-updated date') and how to collect 'Related Commits' (e.g. the git log command and trackId filter) so every output section is fully executable.
Trim the boilerplate 'Use this skill when', 'Do not use this skill when', and generic 'Instructions' sections — they restate the skill name without adding actionable guidance.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is efficient — exact file paths, regex patterns, and a progress-bar formula with no explanation of concepts Claude already knows. However, generic filler sections ("Working on conductor status tasks or workflows", "Clarify goals, constraints, and required inputs. Apply relevant best practices and validate outcomes") add no information and could be trimmed, matching anchor 4 ('minor instances of over-explanation') rather than anchor 5's every-token-earns-its-place. | 4 / 5 |
Actionability | Mostly executable: concrete paths (conductor/tracks/{trackId}/plan.md), executable regexes (/^- \[x\] Task/), an exact progress-bar formula, and complete output/error templates. Minor gaps keep it below anchor 5: how to determine the "Active Track", how to gather "Related Commits" for the git history section, and how to detect "Dependencies on incomplete tracks" are never specified. | 4 / 5 |
Workflow Clarity | Clear sequence (Pre-flight Checks → numbered Data Collection → Output) with explicit validation checkpoints (init verification, no-tracks, track-not-found) and feedback loops for error recovery ("If missing: Display error and suggest running /conductor:setup first", plus a track-not-found template listing available tracks). This read-only reporting skill carries no destructive-operation risk, so the validation cap does not apply, and it matches anchor 5. | 5 / 5 |
Progressive Disclosure | Sections are well organized with clear headers, but the skill's only external reference — "If detailed examples are required, open `resources/implementation-playbook.md`" — points to a file that does not exist in the bundle (no references/, scripts/, assets/, or resources/ directory is present), and ~130 lines of ASCII output templates are inlined that arguably belong in a reference file. This matches anchor 3 ('some structure... references present but not clearly signaled / resolvable') better than anchor 4. | 3 / 5 |
Total | 16 / 20 Passed |