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 highly actionable with strong, validated workflows and copy-paste commands, but it is over-long for a SKILL.md: repeated rationale anecdotes hurt conciseness, and the monolithic single-file structure with no bundle references limits progressive disclosure.
Suggestions
Trim version-history anecdotes ("Found by a dogfood", the v0.8.0 fired-rate story) to one-line justifications or move them to a CHANGELOG; the directive rule is what Claude needs, not the discovery narrative.
Split each sub-command's detailed branches (audit, experiment, contribute) into reference files under references/ and keep SKILL.md as a concise overview pointing one level deep, which would raise progressive disclosure.
Consolidate the repeated emphatic warnings ("Never...", "⚠") into a single constraints section; the current density of inline admonitions adds tokens without adding actionability.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | It assumes Claude's competence and avoids explaining known concepts, but the extensive version-history anecdotes ("Found by a dogfood", "v0.8.0 led with...") and repeated emphatic rationale are over-explanation that could be tightened beyond a minor trim. | 3 / 5 |
Actionability | Copy-paste bash blocks, exact flags, concrete JSON payloads, and field-keyed decision branches make the guidance fully executable across the common cases (audit, experiment, dashboard, contribute, propose, schedule). | 5 / 5 |
Workflow Clarity | Multi-step processes are explicitly sequenced with validation checkpoints and feedback loops — the audit's three rules, contribute's four non-skippable steps with degrade-to-silence, and engine-refusal gates for destructive/batch operations. | 5 / 5 |
Progressive Disclosure | No bundle files exist (references/scripts/assets absent), yet the single ~356-line file inlines substantial per-command detail that could be split into reference files; section headers and external doc links provide structure but content that should be separate stays inline. | 3 / 5 |
Total | 16 / 20 Passed |