tidy-code

Installation
SKILL.md

Review the codebase against the 16 tc-* structural-quality categories and produce one consolidated plan a downstream agent or human can execute. The review is read-only. The state file is your own scratch for resuming — not for human review. Mirror the four phases in the host's todo tool.

Non-negotiables (read first)

  • Never modify source files. The only files this skill writes are the state file and the final plan.
  • Explicit invocation only. Run via /tidy-code; never auto-activate from a natural-language request.
  • Classify every finding FALSIFIABLE (cites a specific snippet on a specific line that Grep can confirm) or OPINION (the evidence is interpretation).
  • Grep-verify every falsifiable citation before it enters the draft. No match, or a match at a different line, drops the finding.
  • Depth 1. Exactly one adversarial-review round. The reviewer never re-runs the file-review pass.
  • Single output file. The final plan is the only user-facing artifact; surface only its path.

Excluded paths

Skip discovery and review in:

Installs
38
Repository
ggwicz/skills
First Seen
Apr 20, 2026
tidy-code — ggwicz/skills