Content
90%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.
An exemplary instruction-skill body: lean, fully actionable via a complete CLI synopsis, with explicit status/validation mechanisms and keyed error handling. The residual weaknesses are two bundle-relative links that do not resolve against the shipped files and validation guidance that is distributed across rules rather than presented as a sequenced workflow.
Suggestions
Ship `schemas/journal.md` and `kendex.settings.toml.example` in the bundle (or correct their paths) so the § links resolve for the reader.
Add a short numbered setup flow (install → setup → listen) with a `listen --status` checkpoint after each step.
Move the per-field `read` output line format and doctor row field list into a reference file to slim the body further.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body defers all per-verb detail to "slack --help" and every rule carries only operational facts (keyed refusals, exit codes, the 12,000-character cap, mrkdwn escaping). No concept Claude already knows is explained and no section is padded — every token earns its place. | 5 / 5 |
Actionability | The opening block gives a complete executable CLI synopsis with every flag for all six verbs, and rules name concrete commands ("run `slack setup` for each bound root", "`lane-mail send --delivery-id`") plus concrete outcomes (`text-too-long`, exit 0, exit 2). This is copy-paste-ready guidance covering the common cases, matching the 5 anchor; it is not a 4 because no guidance is merely high-level. | 5 / 5 |
Workflow Clarity | The setup → listen → post sequence is clear from the synopsis and Rules, and validation exists via "slack listen --status" with "state=ok|failing|stale|never" and `fix=` plus retry-on-next-poll and `already_reacted` settlement. It is not a 5 because the checkpoints are scattered across rules rather than laid out as a sequenced flow with feedback loops, and not a 3 because explicit status/validation and error-recovery behavior are present. | 4 / 5 |
Progressive Disclosure | Sections (Rules / Message standard / Doctor row) are well organized, references are clearly signaled with section anchors, and the primary disclosure runs through the real `scripts/slack` entry point. It is not a 5 because two referenced paths — [schemas/journal.md](schemas/journal.md) and [kendex.settings.toml.example](kendex.settings.toml.example) — do not exist in the provided bundle, and detailed output-format specs (the `read` line format, doctor row fields) are inlined rather than split out. | 4 / 5 |
Total | 18 / 20 Passed |