Content
85%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
Highly actionable and well-sequenced with strong validation checkpoints and a useful anti-patterns table. The main weakness is redundancy: the upstream-diff and tests-exclusion rationales are repeated across Step 6, the Verify blocks, the Worked Example, and the Anti-patterns.
Suggestions
Consolidate the `--upstream main` rationale into one place (Step 6) and have the Worked Example and Anti-patterns reference it rather than re-explaining it.
Merge the 'Excluding `**/test/**` is required' note and the Anti-patterns 'Scan tests + production' row into a single statement of the rule to avoid repeating the qa-test-review/qa-code-quality ownership rationale.
Consider trimming the Worked Example to only the parts not already demonstrated in Steps 1-6, since it currently re-narrates the full flow.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Code blocks and most prose are lean and executable, but the `--upstream main` rationale, the tests-exclusion rationale, and the Worked Example restate guidance already given in Steps 1-6 and the Anti-patterns table, so it could be tightened. | 2 / 3 |
Actionability | Provides fully executable, copy-paste-ready install commands, complete `.codeclimate.yml` and `qlty.toml` config blocks, and concrete `qlty check/smells/metrics` invocations plus a CI yaml with `QLTY_TOKEN`. | 3 / 3 |
Workflow Clarity | Clear 6-step sequence with two explicit Verify checkpoints and feedback loops (e.g. 'assert a newly introduced duplicate block fails while pre-existing findings stay green'; 'confirm `--upstream main` is set and the base branch is correct, then re-run'). | 3 / 3 |
Progressive Disclosure | No bundle files exist; the body is organized into clear titled sections with a one-level-deep References section linking three external docs and no nested references, satisfying the simple-skill allowance. | 3 / 3 |
Total | 11 / 12 Passed |