About ponytail-audit
A one-shot repository-wide audit skill for finding over-engineering and complexity. It ranks suggested cuts by impact, reports findings only, and leaves code unchanged.
Key features
- 01Scan the entire repository
- 02Rank complexity findings by size
- 03Flag dead code and needless layers
- 04Suggest standard-library replacements
- 05Make no changes to files
Use cases
- 01Audit a repository for removable complexity
- 02Find wrappers or abstractions with one caller
- 03Identify unused flags and configuration
- 04Separate complexity review from bug review
Install
Copy the command and run it in a terminal.
npx skills add https:/After installing, type/ponytail-auditin Claude Code to confirm it loaded.
Details
From the project READMEponytail-review, repo-wide. Scan the whole tree instead of a diff. Rank findings biggest cut first.
Tags
Same as ponytail-review:
delete:dead code, unused flexibility, speculative feature. Replacement: nothing.stdlib:hand-rolled thing the standard library ships. Name the function.native:dependency or code doing what the platform already does. Name the feature.yagni:abstraction with one implementation, config nobody sets, layer with one caller.shrink:same logic, fewer lines. Show the shorter form.
Hunt
Deps the stdlib or platform already ships, single-implementation interfaces, factories with one product, wrappers that only delegate, files exporting one thing, dead flags and config, hand-rolled stdlib.
Output
One line per finding, ranked: <tag> <what to cut>. <replacement>. [path].
End with net: -<N> lines, -<M> deps possible. Nothing to cut: Lean already. Ship.
Boundaries
Scope: over-engineering and complexity only. Correctness bugs, security holes, and performance are explicitly out of scope. Route them to a normal review pass. Lists findings, applies nothing. One-shot. "stop ponytail-audit" or "normal mode" to revert.