에이전트 스킬로, 모든 코드베이스를 감사하고 다른 에이전트가 실행할 구현 계획을 작성합니다.

아이디어는: 지능이 복합되는 부분 — 코드베이스 이해, 가치 판단, 명세 작성 — 에 가장 능력 있는 모델을 사용하는 것입니다 — 그리고 더 저렴한 모델에 실행을 손으로 전달하는 것. 기술은 스스로 아무것도 구현하지 않습니다. 계획이 곧 결과물입니다.

설치

에이전트 스킬 포맷을 지원하는 모든 에이전트에서 작동합니다. 작성되는 도면은 일반 할인 도면이라 누구나 (또는 인간)가 받을 수 있습니다.

사용

사용 방법

일반적인 첫 주행 시작부터 끝까지:

1. 저장소에서 에이전트를 열고 /improve(또는 /improve quick를 실행해 저렴하게 만듭니다).
2. 저장소를 매핑하고 감사한 후 결과 표를 제공합니다. 계획하고 싶은 항목들 — “계획 1, 3, 5” — 을 답장하세요.
3. 도면은 plans/에 도착합니다 — 각 파일 하나와 권장 순서가 담긴 색인. 읽으세요; 검토용입니다.
4. 어떤 에이전트에게도 계획을 전달하거나(“implement plans/001-*.md”), 또는 스킬에 의해 실행하게 한다: /improve execute 001. 이 도구는 고립된 워크트리에서 더 저렴한 모델을 배포하고, 계획과 비교하여 차이를 검토한 뒤 결과를 보고한다. 병합은 본인의 몫이다.

improve

An agent skill that audits any codebase and writes implementation plans for other agents to execute.

The idea: use your most capable model for the part where intelligence compounds — understanding the codebase, judging what’s worth doing, writing the spec — and hand execution to cheaper models. The skill never implements anything itself. The plan is the product.

you          →  /improve                    (expensive model, advises)
plans/       →  001-fix-n-plus-one.md       (self-contained specs)
other agent  →  implements, tests, ships    (cheap model, executes)

Install

npx skills add shadcn/improve

Works in any agent that supports Agent Skills format. The plans it writes are plain markdown, so any agent (or human) can pick them up.

Usage

/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      skip the audit, spec one thing
/improve review-plan      critique and tighten an existing plan
/improve execute          dispatch a cheaper executor, review its work
/improve reconcile              refresh the backlog: verify, unblock, retire
/improve ... --issues           also publish plans as GitHub issues

How to use

A typical first run, start to finish:

1. Open your agent in the repo and run /improve (or /improve quick to keep it cheap).
2. It maps the repo, audits it, and comes back with a findings table. Reply with the ones you want planned — “plan 1, 3 and 5”.
3. Plans land in plans/ — one file each, plus an index with the recommended order. Read them; they’re meant to be reviewed.
4. Hand a plan to any agent (“implement plans/001-*.md”), or let the skill run it: /improve execute 001. It dispatches a cheaper model in an isolated worktree, reviews the diff against the plan, and reports back with a verdict. Merging stays up to you.
5. Next session, run /improve reconcile to clean up the backlog: verify what landed, refresh what drifted, unblock what got stuck.

Before a PR, /improve branch does the same thing scoped to just what your branch changes.

Example

A run against shadcn/ui came back with findings like:

| # | Finding                                        | Category  | Effort | Confidence |
|---|------------------------------------------------|-----------|--------|------------|
| 1 | shadow-config duplicated in search.ts/view.ts, | tech-debt | M      | HIGH       |
|   | copies already drifted (TODO at search.ts:31)  |           |        |            |