Content
88%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 well-engineered, concise workflow skill with strong sequencing and validation. Its main weakness is progressive disclosure: the body points to multiple reference documents that are not bundled alongside the scripts.
Suggestions
Bundle the referenced documents (repo-policy.md, checks/tier-0-gates.md, checks/tier-1-correctness.md, checks/tier-2-quality.md, tiebreakers.md, templates/verdict.md, validation/backtest.md) so the signaled references resolve to real files.
Inline a one-line summary of each Tier 1/Tier 2 check in the body so the core correctness/quality actions are actionable even before opening the referenced files.
Clarify that ../nemoclaw-maintainer-policies/references/workflow-policy.md is an external dependency so readers know it lives outside this skill's bundle.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and directive throughout; it avoids explaining what PRs/CI/merge are and limits prose to genuinely non-obvious domain detail (the supersession parser grammar), so every token earns its place. | 5 / 5 |
Actionability | Provides many copy-paste-ready commands (gh issue view, find-candidates.sh, gate scripts, git fetch, render-verdict.py) and explicit scoring rules, but the substantive Tier 1/Tier 2 check definitions are deferred to referenced files, leaving a minor gap in the body itself. | 4 / 5 |
Workflow Clarity | A 9-step sequenced workflow with a copy-in checklist and explicit validation/feedback checkpoints ('Stop if the renderer exits with a nonzero status', 'Stop if a candidate omits a required key', 'Do not accept a mode from the caller') fits the explicit-validation-with-feedback-loops anchor. | 5 / 5 |
Progressive Disclosure | Clean overview structure with well-signaled one-level-deep references organized in dedicated sections, but several referenced documents (repo-policy.md, checks/*.md, tiebreakers.md, templates/verdict.md, validation/backtest.md) are not present in the bundle, weakening navigation. | 4 / 5 |
Total | 18 / 20 Passed |