Content
85%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 dense, highly actionable workflow skill with explicit gates, validation checkpoints, and well-signaled references to in-tree guides. Its main weakness is length — several meta and inline-gotcha passages could be trimmed or deferred to the referenced docs.
Suggestions
Tighten the intro and 'Status: v0' section — the framing about dogfooding and updating logs can be shortened without losing the flag-and-update guidance.
Move the four inline trap explanations in gate 2 to a one-line summary each with a pointer to HARNESS-GOTCHAS, keeping only the trap name and the rule in the body.
Collapse repeated JSON-verdict guidance (gates 6 and the tools table both restate 'read effverify --json, not the raw log') into a single authoritative statement to reclaim tokens.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient and free of basic-concept padding, but the intro, the v0 Status section, and the inline four-trap explanations in gate 2 could be tightened or pushed to the referenced gotchas docs; the body is long even for a routing skill. | 3 / 5 |
Actionability | Concrete executable commands with exact flags throughout (effnext --json, effscaffold <Class.method> --json, effcheck/effbuild/effverify --json) plus a copy-paste-ready @Converted Kotlin snippet and named verdict fields to read. | 5 / 5 |
Workflow Clarity | A clearly sequenced 10-gate loop (0–9) with explicit validation checkpoints (effcheck pre-flight, effverify done-gate, parity diff), feedback loops (efftriage on failure), and a close-out checklist — validation is present for this batch/conversion operation. | 5 / 5 |
Progressive Disclosure | Acts as an overview that routes to one-level-deep in-tree guides via a clear reference table and a tools table; no bundle files ship locally, but the structure is well-signaled and navigable rather than monolithic. | 5 / 5 |
Total | 18 / 20 Passed |