ponytail-audit

Community

Rank repo-wide code bloat for fast cleanup.

Authorbketelsen
Version1.0.0
Installs0

System Documentation

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.

Dependency Matrix

Required Modules

None required

Components

Standard package

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: ponytail-audit
Download link: https://github.com/bketelsen/ytsejam/archive/main.zip#ponytail-audit

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 510,000+ vetted skills library on demand.