Improve

Why it's ranked here

Its strongest idea is disciplined separation between judgment and implementation. Findings require file-and-line evidence, the advisor rechecks reported locations, and users choose which items become plans. The follow-through is unusually complete: it can track drift, refresh stale work, dispatch an isolated executor, and verify the resulting diff without merging it.

What's good

Plans target agents with no prior session context. They inline current code, repository conventions, test commands, dependencies, exclusions, and machine-checkable completion criteria. The audit covers correctness, security, performance, tests, architecture, dependencies, developer experience, documentation, and product direction. Rejected findings are recorded, reducing repeated false positives during later audits.

Tradeoffs

The advisor deliberately refuses direct source edits, so it cannot replace an implementation agent or finish a change by itself. Its value depends on the host supporting Agent Skills, and automated execution additionally depends on subagents, Git, and isolated worktrees. Thorough audits can fan out across several specialist agents, which increases model usage before implementation begins.

How to use it well

It suits teams that want careful technical triage followed by explicit handoffs to agents or humans. Start with a repository audit, select only worthwhile findings, inspect the generated specifications, then assign them to executors. Use branch-focused analysis before pull requests and backlog reconciliation between sessions. Choose another tool when you need direct editing, merging, or deployment.

Observed

License

MIT

Primary format

Markdown agent skill and Markdown implementation plans, with JSON plugin metadata

Install surface

Installed with npx skills add shadcn/improve

Interface

Agent Skill with slash-command variants for audits, planning, execution review, reconciliation, and GitHub issue publication

Platform support

Works in agents that support the Agent Skills format

Source behavior

The advisor writes only planning artifacts; separate executors may edit code in isolated Git worktrees

Repository structure

Includes a sample generated plan plus separate audit, plan-template, and closing-the-loop references