junk-detection
Installation
SKILL.md
Junk detection
Separate bad aesthetics from bad incentives. Find code that optimizes a proxy, preserves a constraint that no longer exists, or makes future change harder without buying required behavior.
Read references/taxonomy.md before the first audit in a task. Treat the scanner as triage, never as a verdict.
Choose the audit surface
- Read repository instructions and the relevant product or domain contract.
- For branch or PR work, compare the merge-base with
origin/main(or the repository's actual trunk) throughHEAD, then include staged, unstaged, and untracked work. - For a whole-codebase request, start with changed and frequently touched paths, then broaden to all first-party code.
- Exclude generated, vendored, minified, lock, fixture, snapshot, and migration output unless the request targets it.
- Preserve the user's existing changes. Audit only unless the user also asks for fixes.
Run the bundled triage script from the repository root: