Content
63%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 review workflow itself is exceptionally actionable — exact commands, classification schemes, output templates, and verification checkpoints throughout. But the file is bloated by hundreds of lines of gstack framework boilerplate (persona, telemetry prompting, contributor mode) that is irrelevant to the review task, and the detailed checklists it depends on are not actually shipped in the bundle.
Suggestions
Move the framework-wide policy sections (Voice, AskUserQuestion Format, Completeness Principle, Contributor Mode, telemetry flows) into a shared gstack reference file loaded once, cutting ~325 lines of off-task content from this skill's context load.
Ship checklist.md, greptile-triage.md, and design-checklist.md inside the skill's own references/ directory (or bundle the key rules inline) so the skill is self-contained and the references resolve reliably.
Clean up the step structure: remove the duplicated 'Step 4.5' heading and renumber the awkward decimal steps (4.5, 4.75, 5.5, 5.6, 5.8) into a coherent sequence so the workflow is easier to follow.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is ~950 lines, and roughly the first 325 (the gstack "Voice" persona, AskUserQuestion format, Completeness Principle, telemetry/lake-intro prompting flows, Contributor Mode) are framework policy unrelated to reviewing a PR; telemetry logging is even specified twice (preamble and "run last"), and the "Step 4.5" heading appears duplicated back-to-back. This matches 'noticeably verbose; several unnecessary explanations or padded sections' — it is not a 1 because the core review steps are dense and command-driven rather than explaining concepts Claude already knows, and not a 3 because the volume of off-task padding goes well beyond 'could be tightened'. | 2 / 5 |
Actionability | Guidance is fully executable: exact commands ("git diff origin/<base>", "gh pr view --json baseRefName -q .baseRefName", glab and git-native fallback chains), explicit classification schemes (DONE/PARTIAL/NOT DONE/CHANGED), concrete output templates, and precise substitution tables (TIMESTAMP, STATUS, N, COMMIT). Copy-paste-ready commands with fallbacks cover the common cases, matching the top anchor. | 5 / 5 |
Workflow Clarity | Steps are clearly sequenced (Step 0 through 5.8) with explicit stop/skip conditions, a verification-of-claims checkpoint ("Never say 'likely handled' or 'probably tested'"), a mandatory regression rule, and an escalation protocol — most checkpoints are present. It falls short of anchor 5 because the decimal step numbering (4.5, 4.75, 5.5, 5.6, 5.8 with no 5.7), the duplicated Step 4.5 heading, and interleaving of framework policy make the sequence harder to follow than a clean validate/fix/retry loop. | 4 / 5 |
Progressive Disclosure | References to checklist.md, greptile-triage.md, and design-checklist.md are one level deep and clearly signaled, but none of them ship in this skill's bundle (no references/, scripts/, or assets/ exist — they resolve to an external gstack install), and ~40% of the body is framework-wide policy that belongs in shared reference files. This matches 'some structure but could be better organized; content that should be separate is inline' — not anchor 2 because real structure and explicit references exist, not anchor 4 because the inline policy content is far more than a minor organization gap. | 3 / 5 |
Total | 14 / 20 Passed |