Content
96%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 tight, fully executable orchestration runbook: complete Workflow calls, exact resume/checkpoint semantics, validation gates between sittings, and error recovery. Its only structural weakness is that all detail lives in one inline file with no progressive disclosure into reference files.
Suggestions
Move the ballot-construction rules (section 5) and the seven-item verdict report format (section 6) into a reference file (e.g. references/ballot.md and references/report.md), keeping SKILL.md a lean overview that links to them one level deep.
Consider moving the seat roster (the sixteen seats and the balanced quick eight) into a small reference table so the seating options don't occupy body lines.
Trim a few stylistic flourishes ('The members' own words are the product', 'Close with one line of candour') to purely imperative phrasing to save tokens.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Every line is operational: word budgets ('150 to 400 words of plain prose', 'at most 120 words'), seat lists, call counts ('up to 160 short agent calls'), and exact field semantics. No concept Claude already knows is explained, and nothing is padded, matching the lean anchor-5; anchor 4's 'minor instances of over-explanation' has no clear candidate in the text. | 5 / 5 |
Actionability | Guidance is copy-paste ready: complete Workflow invocations with exact args ('Workflow({ name: "council:deliberation", args: { brief, seats, sittings: 1 } })' and the resume pattern with resumeFromRunId/expect), a concrete ballot schema ('ids A, B, ..., each with a title of at most six words and a summary of at most 50 words'), and exact error strings to match ('Error "resend them unchanged"'). This matches the fully-executable anchor-5. | 5 / 5 |
Workflow Clarity | Six clearly numbered sections sequence the whole process with explicit checkpoints: confirm the matter before convening, 'Show the brief to the user, then proceed', relay each sitting, gate on 'status is ready_for_ballot' before step 5, and the expect-checkpoint mechanism that turns a changed brief into an error. A dedicated error-recovery section ('When something fails') with three specific failure modes and remedies completes the feedback loops, matching anchor-5. | 5 / 5 |
Progressive Disclosure | The single SKILL.md is well organized into clearly headed sections that a clerk follows top to bottom, and it points to plugin resources (agents/ per seat, the council:deliberation workflow) rather than duplicating them — good structure, matching anchor 4. It is not anchor 5: the file runs ~155 lines with everything inline (ballot rules, report format, error handling could live in reference files), so the under-50-lines simple-skill exception does not apply, and there are no one-level-deep reference files to signal. | 4 / 5 |
Total | 19 / 20 Passed |