ponytail-audit

Scan entire codebases for over-engineering and generate a ranked remediation list.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/bketelsen/ytsejam --skill ponytail-audit
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ponytail-audit
Source: https://github.com/bketelsen/ytsejam/tree/main/contrib/skills/ponytail-audit
Command: npx skills add https://github.com/bketelsen/ytsejam --skill ponytail-audit

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Whole-repo audit for over-engineering. Like ponytail-review, but scans the entire codebase instead of a diff — a ranked list of what to delete, simplify, or replace with stdlib/native/dep equivalents. Use when the user says "audit this codebase", "audit for over-engineering", "what can I delete from this repo", "find bloat in this repo", "ponytail-audit", or "/ponytail-audit". One-shot report — does not apply fixes.

Core Features & Use Cases

  • Step 1 — Confirm scope: Root, Focus, Excludes; Confirm root + focus before dispatching the scan.
  • Step 2 — Dispatch the scan: For non-trivial repos, dispatch a read-only subagent via delegate, with a conservative mandate and a ranking output.
  • Output template and guidance: outlines the audit report structure, the categories to hunt (delete, stdlib, native, dep, yagni, shrink) and the conservative stance.
  • BE CONSERVATIVE: Changes that affect API, observable behavior, or intentional design choices are not bloat; list them for design review.

Quick Start

Run ponytail-audit in the repository to dispatch a read-only scan and generate a ranked list of over-engineering findings.

Frequently Asked Questions about ponytail-audit

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I audit my codebase for over-engineering and code bloat?

To audit a codebase for over-engineering, you can run a whole-repo scan that analyzes the entire file tree to identify bloated patterns and generate a ranked remediation list. The audit operates conservatively and read-only, outputting a findings table without applying fixes.

What is the best way to find code to delete or simplify across a large repository?

Finding code to delete across a large repository involves scanning the entire tree for categories like stdlib reinventions, unnecessary dependencies, and YAGNI violations. The scan produces a ranked list of what to delete, simplify, or replace with native equivalents.

Can I focus my static analysis on specific categories like vendor code or dependencies?

Yes, you can focus static analysis on specific categories like vendor code, dependencies, or stdlib reinventions. The scan allows you to configure excludes and confirm the root directory and focus area before dispatching the read-only audit.

Does a codebase audit for bloat modify my existing source files?

No, a codebase audit for bloat does not modify your source files. It implements a conservative, read-only workflow that generates a report containing a ranked findings table and a NOT BLOAT section for design review.

What categories of over-engineering should I look for when scanning a repo?

When scanning a repo for over-engineering, the categories to hunt include code to delete, stdlib replacements, native equivalents, dependency substitutions, YAGNI violations, and areas to shrink. A conservative stance ensures intentional design choices are separated into a NOT BLOAT section.