review-llm-artifacts
Installation
SKILL.md
LLM Artifacts Review
Detect common artifacts left behind by LLM coding agents: over-abstraction, dead code, DRY violations in tests, verbose comments, and defensive overkill.
Hard gates (sequence)
Advance only when each pass condition is objectively true (prevents “review complete” without artifacts):
| Gate | Pass condition |
|---|---|
| G1 — Scope | File list is non-empty or you exit with exactly the Step 1 message; scope is set to all or changed. |
| G2 — Four categories | Tests, dead code, abstraction, and style are each reviewed (four parallel subagent runs when supported, or four sequential passes covering the same categories). Stop if any category did not complete; do not write JSON or a summary that implies a full pass. |
| G3 — JSON before summary | .beagle/llm-artifacts-review.json exists and is valid JSON before Step 6 markdown. |
| G4 — Integrity | Step 7 checks pass before treating the run as complete. |
Arguments
Parse $ARGUMENTS for flags and optional path: