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.
A highly actionable protocol spec with excellent workflow sequencing and validation checkpoints, but it is long for a SKILL.md and keeps substantial detailed material (output templates, the quality loop) inline rather than offloading it to reference files.
Suggestions
Move the User Communication Standard output templates (standard, proactive alert, board meeting) into a references/ file and keep only the rule summary inline, reducing SKILL.md length and the conciseness penalty.
Extract the 4-step Internal Quality Loop (self-verify checklist, peer-verification table, critic pre-screen, course correction) into its own reference file, leaving a brief overview and stakes table in SKILL.md.
Remove the Quick Reference recap table and the in-body 'When to Invoke vs When to Assume' section, since both duplicate rules already stated above and the latter is fully covered in references/invocation-patterns.md.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is competent and avoids explaining concepts Claude already knows, but at ~451 lines it carries redundancy — the Quick Reference table recapitulates the loop-prevention rules, and the 'When to Invoke vs When to Assume' guidance is duplicated in references/invocation-patterns.md — so it could be tightened rather than being merely minor over-explanation (4). | 3 / 5 |
Actionability | Every protocol construct ships as a copy-paste-ready template with a fully filled worked example — [INVOKE], [RESPONSE] with the CFO hiring example, [BLOCKED], [ASSUMPTION], [CONFLICT], [BROADCAST], [PEER-VERIFY], [CRITIC-SCREEN] — covering the common cases concretely. | 5 / 5 |
Workflow Clarity | Multi-step processes are explicitly sequenced with validation checkpoints and feedback loops: the 4-step Internal Quality Loop, the SELF-VERIFY CHECKLIST with explicit gates ('If >50% ASSUMED → flag low confidence', 'Only proceed when validation passes'), the founder feedback loop with re-verify, and the Verification Level by Stakes table. | 5 / 5 |
Progressive Disclosure | Headers and the single clearly-signaled, one-level-deep reference (references/invocation-patterns.md) give good navigation, but large detailed blocks — the User Communication Standard templates and the 4-step quality loop with its tables — are inlined in SKILL.md rather than split into reference files, fitting the 'content that should be separate is inline' anchor. | 3 / 5 |
Total | 16 / 20 Passed |