# /ponytail-review: A plain-English review that reads past the diff

Source: https://trendhub.net/skills/dietrichgebert-ponytail/ponytail-review
Skill folder: https://github.com/DietrichGebert/ponytail/tree/main/skills/ponytail-review
Pack: Ponytail (https://trendhub.net/skills/dietrichgebert-ponytail)
Works with: Claude Code, Codex

Ponytail-review reviews a change as if you would be paged when it breaks. It reads callers and called functions beyond the diff, traces where data enters and leaves, assumes a load from the repo, and checks correctness, safety, scale, tests, speed and excess code. Every finding needs a concrete failing case and comes with what it is, the problem, the fix and the cost of skipping it.

## When to use it

- You want a review of uncommitted changes, a branch, the last commit or a PR link.
- A change renames a field or alters a return value that other files depend on.
- You suspect a change is over-engineered and want to know what can go.

## How it works

1. **Pick the target**: The agent reviews what you name, or uncommitted changes, or the last commit when nothing is pending.
2. **Read connected code**: It reads callers, callees, tests and the README, greps every caller when a signature or behavior changes, and states the load it assumed.
3. **Check six areas**: It looks for bugs, security and data-loss risks, scale problems, missing tests on risky logic, real slowness and code that should be deleted, reused or merged.
4. **Prove each finding**: It drops anything without a concrete input that produces a wrong result and treats documented shortcut: comments as decisions.
5. **Report**: It groups numbered findings into must, should and nice to have, ends with a verdict and possible line savings, and changes no code.

## What it steers the agent away from

- Style opinions and vague consider-this comments
- Missing breakage in files the diff never touched
- Fixes that add layers, frameworks or config

## What it can touch

Reads the diff and related files and runs git and grep commands; it produces a report only and does not edit code.

## Pairs well with

- `/ponytail-audit`
- `/ponytail`

## Questions

### Will it fix the problems it finds?

No. It only reports; findings are numbered so you can ask the agent to fix specific ones afterwards.

### Who is the report written for?

It uses short sentences and explains technical terms on first use, assuming the reader may never have seen the code.
