How shadcn/improve works
Improve is an agent skill that audits a codebase and produces implementation plans; it does not implement source changes itself. The main workflow is recon, parallel audit, vetting and prioritization, then plan writing. Its documented branches include focused audits, feature suggestions, plan review, execution by a cheaper agent, reconciliation, and optional GitHub issue publication. The source excerpts were unavailable, so relationships below are limited to those explicitly described in the README; skill internals share the listed skill path.
Main entry points: SKILL.md Improve skill
Components 18
Audit to plan
- Improve skill
skills/improve/SKILL.md - Repository recon
skills/improve/SKILL.md - Parallel audit
skills/improve/SKILL.md - Finding vetting
skills/improve/SKILL.md - Prioritization
skills/improve/SKILL.md - Plan writing
skills/improve/SKILL.md - Quick audit
skills/improve/SKILL.md - Deep audit
skills/improve/SKILL.md - Focused audit
skills/improve/SKILL.md - Branch audit
skills/improve/SKILL.md - Feature suggestions
skills/improve/SKILL.md
Plan operations
- Executor agent
- Execution review
skills/improve/SKILL.md - Backlog reconcile
skills/improve/SKILL.md - Plan critique
skills/improve/SKILL.md
Plan outputs
- Plan files
- GitHub issues
Other components
- User
Connections 20
- User → Improve skill: invokes
README.md - Improve skill → Repository recon: maps repository
README.md - Improve skill → Parallel audit: fans out
README.md - Improve skill → Finding vetting: rechecks findings
README.md - Improve skill → Prioritization: orders findings
README.md - User → Plan writing: selects findings
README.md - Improve skill → Plan writing: writes plans
README.md - Plan writing → Plan files: produces
README.md - User → Executor agent: hands off plan
README.md - Executor agent → Execution review: returns work
README.md - Improve skill → Execution review: reviews diff
README.md - User → Backlog reconcile: requests refresh
README.md - Improve skill → Backlog reconcile: verifies backlog
README.md - Plan writing → GitHub issues: publishes optionally
README.md - User → Quick audit: requests mode
README.md - User → Deep audit: requests mode
README.md - User → Focused audit: requests category
README.md - User → Branch audit: requests scope
README.md - User → Feature suggestions: requests suggestions
README.md - User → Plan critique: requests critique
README.md