Content
73%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, well-guarded workflow whose script is copy-paste ready, with the main costs being redundant/boilerplate sections and a claimed-but-unimplemented emoji sanitization step. Trimming conformance-test scaffolding and closing the sanitization gap would move both conciseness and actionability up.
Suggestions
Add the emoji sanitization step (command or flag) to the invocation script, or remove the claim from the description and anti-patterns list, so behavior and instructions agree.
Delete or merge the "Contract" and "Output Format" conformance-test sections and fold "The rule" into the opening convention block to cut roughly 20 lines of duplicated content.
Move version-sensitive text ("A future v0.26+ may bundle a fallback...; for v0.25.1 gstack is a soft prereq") into a clearly labeled prerequisites note or drop it, per the time-sensitive-information guideline.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body avoids concept-tutoring but carries clear redundancy: "The rule" restates the opening blockquote, the "Defaults: NO cover, NO TOC" section repeats inline script comments, and the "Contract"/"Output Format" sections admit they exist only "for the conformance test". Time-sensitive version text ("for v0.25.1 gstack is a soft prereq") also pads without a deprecated-section frame. This matches anchor 3 — mostly efficient but includes unnecessary material that could be tightened — rather than 4, where only minor trimming would be needed. | 3 / 5 |
Actionability | The invocation script is executable end-to-end (binary check, gbrain get, dual-source raw fetch, awk frontmatter strip, guarded render) and "Common patterns" gives concrete flag examples. Two gaps keep it from 5: emoji sanitization is claimed ("Skipping emoji sanitization... show up as boxes") but no command or step implements it, and the first common pattern `brain-pdf <slug>` is a pseudo-command with no defined entry point. | 4 / 5 |
Workflow Clarity | The RESOLVE → STRIP → RENDER → DELIVER sequence is mirrored by a fully commented script with explicit validation guards (`[ -x "$P" ]`, `gbrain get` existence check, `[ -s "$CLEAN" ]` empty-output check), and "When it fails" provides error-specific recovery (resolve the real slug after a title search; install gstack rather than hand-rolling a PDF). This matches anchor 5's explicit validation plus feedback loops; the operation is non-destructive, so no batch cap applies. | 5 / 5 |
Progressive Disclosure | A single well-sectioned file for a single-purpose skill, with external conventions (quality.md, agent-operator-protocol.md) and related skills linked one level deep and clearly signaled — no bundle files exist to split into. It falls short of anchor 5 because at ~180 lines the boilerplate "Contract" and "Output Format" sections and duplicated rule/defaults text are organization gaps; the under-50-line simple-skill exception does not apply. | 4 / 5 |
Total | 16 / 20 Passed |