Content
46%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 well-sectioned and token-efficient with sensible safety checkpoints for destructive operations, but it provides only high-level direction with no executable detail, and its single reference to detailed content points at a file that does not exist under two inconsistent paths. The skill is structured as an overview of a playbook that is missing from the bundle.
Suggestions
Fix the broken reference: ship the implementation playbook at one consistent path and reference it once, removing the conflicting `resources/` vs `./sub-skills/` duplication and the redundant Resources/Knowledge Modules sections.
Add concrete, executable guidance to the Instructions (e.g. the actual verification commands or the list of required `conductor/` files) so the skill is actionable even before opening the playbook.
Add a post-operation validation step (e.g. re-read `tracks.md` to confirm the track's state transitioned as expected) to close the feedback loop for destructive and batch operations.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean — short bullet sections with no explanations of concepts Claude already knows. It falls short of 5 due to redundancy: the intro sentence repeats the description, and the implementation playbook is referenced three times (Instructions, Resources, Knowledge Modules) with inconsistent paths (`resources/` vs `./sub-skills/`). | 4 / 5 |
Actionability | Instructions are high-level hints ("Verify `conductor/` structure and required files", "Determine the operation mode from arguments or interactive prompts", "Update `tracks.md` and metadata consistently") with no concrete commands or examples — which required files, how to verify, what a consistent update looks like are all unspecified. It is not a 3 because there is no partially-executable guidance; all executable detail is deferred to a playbook that is not present in the bundle. | 2 / 5 |
Workflow Clarity | A sequence exists (verify structure → determine mode → confirm destructive actions → update metadata) and destructive-operation checkpoints are present ("Confirm destructive actions (delete/cleanup) before applying", "Backup track data before delete operations"). However, this destructive/batch skill has no post-operation validation or feedback loop (e.g. verify the track state or `tracks.md` after the change), which caps workflow clarity at 3 per the judging guidelines. | 3 / 5 |
Progressive Disclosure | The section structure is reasonable, but the referenced detail file does not exist in the bundle — neither `resources/implementation-playbook.md` nor `./sub-skills/implementation-playbook.md` is present, and the two conflicting paths plus a duplicated Resources/Knowledge-Modules listing make navigation unreliable. Scoring against the actual (empty) bundle structure, the one-level-deep reference is broken, so the skill cannot actually reach its detailed content. | 2 / 5 |
Total | 11 / 20 Passed |