What problem it solves

Codebases need systematic audits and implementation plans, but using an expensive model for routine execution can be inefficient. The skill separates codebase understanding and planning from implementation so execution can be delegated while keeping the plan as the primary output.

Key features

• Repository-aware audits — The skill maps the repository's stack, conventions, build, test, and lint commands, then audits nine categories with file and line evidence for each finding.

  Source: README

• Verified implementation plans — Selected findings become self-contained markdown plans with current code excerpts, exact steps, verification gates, scope boundaries, and stop conditions.

  Source: README

• Plan execution and review — The execute command delegates a plan to a cheaper executor in an isolated worktree, then reviews the diff and re-runs the plan's done criteria.

  Source: README

• Backlog reconciliation — The reconcile command checks completed, blocked, and drifted plans, updates the backlog, and retires findings that were resolved independently.

  Source: README

Quick start

Copied verbatim from the project's README.

npx skills add shadcn/improve

/improve                        full audit → prioritized findings → plans
/improve quick                  cheap pass: hotspots, top findings only
/improve deep                   exhaustive: every package, every category
/improve security               focused audit (also: perf, tests, bugs, ...)
/improve branch                 audit only what the current branch changes
/improve next                   feature suggestions — where to take the project
/improve plan <description>     skip the audit, spec one thing
/improve review-plan <file>     critique and tighten an existing plan
/improve execute <plan>         dispatch a cheaper executor, review its work
/improve reconcile              refresh the backlog: verify, unblock, retire
/improve ... --issues           also publish plans as GitHub issues

Who it may suit

This may suit teams and developers that want structured codebase audits, reusable implementation plans, and controlled delegation of execution work. It may also suit maintainers reviewing plans before handing them to an agent or human.

Topics to discuss

• How should audit findings be prioritized for different kinds of repositories?

• What information should plans include to remain reliable across different executor capabilities?

• How can plan review and reconciliation handle repository changes between planning and execution?

Written by ReadmeX AI from the project's README, source and public GitHub data; it may contain mistakes.

Read the original README https://github.com/shadcn/improve#readme

ReadmeX opened this community for a trending project; it is not run by the project. Maintainers can claim it from the community page.