Content
25%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 essentially a promotional pointer to an external GitHub project padded with generic template instructions and sections that duplicate the frontmatter description. Despite claiming to be a technical reference, it contains no actual reference material, code, or actionable guidance.
Suggestions
Replace the generic Instructions filler ("Clarify goals... Apply relevant best practices...") with concrete, task-specific guidance, e.g. actual review steps for a channel factory implementation or code excerpts showing Decker-Wattenhofer/timeout-tree construction.
Delete the duplicated "Purpose" and "Key Topics" sections, which restate the frontmatter description and the SuperScalar paragraph.
Either add real reference material as bundled files (e.g. references/ on factory construction, MuSig2 signing flows, watchtower breach handling) or reframe the body as substantive reference content instead of links to an external repository.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Noticeably padded: the "Purpose" section restates the description nearly verbatim, "Key Topics" re-lists the SuperScalar paragraph as bullets, and the "Instructions" bullets ("Clarify goals, constraints, and required inputs. Apply relevant best practices and validate outcomes.") are generic filler that add nothing. | 2 / 5 |
Actionability | No concrete code, commands, or steps anywhere in the body; it only describes and points elsewhere ("For a production implementation... refer to the SuperScalar project: <URL>"). This matches 'entirely vague or abstract; only describes rather than instructs'. | 1 / 5 |
Workflow Clarity | The three generic bullets (clarify goals → apply best practices → provide steps) form at best a rough, poorly defined sequence with no validation checkpoints — template text rather than a task-specific workflow — matching 'rough sequence present but many gaps; validation absent'. | 2 / 5 |
Progressive Disclosure | The body is short, uses clear section headers, and links are one level deep (external URLs, no bundle files exist). Minor organizational gaps: the SuperScalar promotional paragraph sits under "Instructions" though it is not an instruction, and the Purpose/Key Topics sections duplicate other content. | 4 / 5 |
Total | 9 / 20 Passed |