Improve: Codebase Audit and Plans

Install and use

1. Install the Skill

   Install the upstream Skill together with its audit and plan references.

   npx skills add shadcn/improve

2. Choose a review scope

   Ask for a quick audit or focus on an area, then select the findings to turn into plans.

   Use improve to review this repository for correctness and test coverage. Show the findings before writing plans.

About this Skill

Improve surveys project conventions and verification commands, checks areas such as correctness, security and performance, and presents prioritized findings before writing self-contained Markdown plans. Its advisor does not directly edit source code; an optional execute mode delegates a selected plan to an isolated worktree and reviews the result.

Why we picked it

Useful when you want an actionable backlog before changing code. Plans include scope, verification commands and stop conditions; the optional executor requires a host that supports isolated subagents.

What it helps with

• Turn a repository audit into a prioritized backlog with file-level evidence and verification steps.
• Prepare a specific implementation plan or review an existing plan before handing it to another agent.
• Review a branch or explore product direction using the repository's own context.

Scope and outputs

The standard workflow writes a plans index and one Markdown plan per selected finding. The skill also supports branch review, focused audits, plan review and backlog reconciliation.

The optional execute mode dispatches another agent to an isolated worktree; merging remains a user decision. The --issues option creates GitHub issues, so review plans for sensitive information before publishing.

Before you use it

• An agent able to read the Skill and bundled reference files. Parallel review and execute mode depend on host subagent support; execute additionally requires isolated worktrees. Publishing GitHub issues requires the explicit --issues option and the GitHub CLI.