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 tight, command-first skill body: executable CLI syntax, two clearly sequenced workflows, and a genuinely useful worked example for parked-task capture. Remaining gaps are minor — some duplicated warnings, an undocumented `goal get` command, and no verification step after creating a goal.
Suggestions
Add `hivemind goal get <goal_id>` to the Commands block since the resume workflow depends on it.
Consolidate the write_file/mkdir prohibition into the 'What NOT to do' section only, trimming the opening CRITICAL block to a one-line pointer.
Add a verification checkpoint after `goal add` (e.g., re-run `hivemind goal list --mine` and confirm the goal is team-visible) before reporting the goal_id to the user.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and operational (commands, workflows, a worked example) with no explanation of concepts Claude already knows, matching anchor 4. It misses anchor 5 because the write_file prohibition is repeated across the opening CRITICAL block and the 'What NOT to do' section, and the hivemind-memory caveat restates it — minor duplication that could be trimmed. | 4 / 5 |
Actionability | Commands are concrete and executable ("hivemind goal add", "hivemind goal progress <goal_id> in_progress") and the capture example is fully worked with realistic content, matching anchor 4. It falls short of anchor 5 because "hivemind goal get <goal_id>" is used in the resume workflow but never listed in the Commands block, and flag placement (e.g., `--agent capture`) is only shown once in prose. | 4 / 5 |
Workflow Clarity | Both workflows are clearly numbered with sequenced steps and a useful implicit checkpoint ("capture stdout, that's the `goal_id`"), matching anchor 4. No explicit validation step exists (e.g., confirming the new goal appears in `hivemind goal list --mine` before reporting the goal_id), which keeps it below anchor 5; operations are non-destructive and non-batch, so the destructive-cap rule does not apply. | 4 / 5 |
Progressive Disclosure | The body is ~50 lines, self-contained with no external reference files (no references/, scripts/, or assets/ directories exist), and organized into clearly labeled sections (Commands, Workflow, Capture, Resume, What NOT to do) — matching the guideline that short simple skills with well-organized sections and no need for external references score 5. There are no nested or buried references. | 5 / 5 |
Total | 17 / 20 Passed |