O que é improve?
improve é uma skill de agente do shadcn, autor do shadcn/ui. Você roda `/improve` em um repositório e a skill mapeia o stack e seus comandos de build, teste e lint, audita o código em nove categorias (correção, segurança, desempenho, testes, dívida técnica, dependências, experiência do desenvolvedor, documentação e rumo do produto) e devolve uma tabela de achados. Cada achado cita arquivo e linha, com impacto, esforço e confiança. Você escolhe quais viram planos.
Os planos são o produto. Cada um é um arquivo Markdown em `plans/`, escrito para um modelo que nunca viu a auditoria: o código atual colado, passos exatos, um comando e o resultado esperado depois de cada passo, uma lista do que fica de fora e condições STOP para quando o código não bate. A skill nunca edita o código-fonte; `/improve execute` entrega um plano a um executor separado em um git worktree e revisa o diff. O repositório tem 12.083 estrelas, licença MIT, 23 commits e nenhuma release marcada; o último commit é de 12 de setembro de 2026.
improve vale a pena?
A ideia por trás do improve é econômica: gastar o modelo forte em julgamento e o barato em digitação. Na nossa leitura da skill, a disciplina que faz isso funcionar está no modelo de plano. Cada passo termina com um comando de verificação e a saída esperada, o plano registra o commit do git contra o qual foi escrito para que o executor confira se houve mudança, e as condições STOP dizem a um modelo pequeno para parar e relatar em vez de improvisar.
A auditoria foi feita para resistir à falha comum da revisão de código por IA, que é o absurdo dito com confiança. Os subagentes relatam demais, diz a skill, então o orientador reabre cada local citado antes de mostrar um achado, descarta falsos positivos, corrige atribuições erradas e registra as rejeições para que não voltem na próxima rodada. O exemplo do README no shadcn/ui mostra os dois lados: um laço O(n²) em uma linha específica fica, um suposto "SSRF" por variável de proxy sai como comportamento esperado.
A profundidade é um controle de custo. `quick` usa no máximo um subagente e traz cerca de 6 achados de alta confiança; o padrão permite até 4 subagentes simultâneos; `deep` permite até 8, um por categoria, em todos os pacotes. Quando `execute` roda, o executor usa Sonnet por padrão, a menos que você indique outro modelo, e um plano tem no máximo 2 rodadas de revisão antes de ser bloqueado.
O porém: não há contagem de tokens nem economia publicadas, então a tese de que a execução barata paga a auditoria cara não está comprovada no repositório. Uma rodada `deep` em uma base de código grande significa várias sessões longas de subagentes no seu modelo mais forte. A opção `--issues` publica os planos como issues do GitHub; a skill verifica a visibilidade e pergunta antes de publicar achados de segurança em um repositório público, mas uma confirmação é uma barreira fraca contra expor ao mundo onde está uma credencial. Não há releases, e nada foi commitado desde setembro.
Nossa opinião: improve rende mais como hábito do que como evento único, um `/improve quick` por mês e um `/improve branch` antes de cada pull request, com os planos lidos por uma pessoa antes que qualquer modelo aja.
Onde ele se destaca
Um tech lead que herda um serviço TypeScript de porte médio
Encontrar, com evidências, as poucas correções que valem ser feitas primeiro
Rode `/improve` e responda com os achados que quer planejar, por exemplo "plan 1, 3 and 5". Os planos chegam em `plans/` com índice e ordem; a árvore de código fica intocada.
Um mantenedor solo de uma biblioteca de código aberto
Transformar uma auditoria em tarefas que colaboradores possam pegar
Os planos são Markdown autocontido e podem ir do jeito que estão para um colaborador ou um agente. Publique como issues com `--issues` só depois de ler cada um, porque planos de segurança em repositório público ficam públicos.
Uma desenvolvedora com orçamento fixo de modelo
Usar o modelo caro na revisão e um mais barato nas edições
`/improve execute 001` dispara um executor Sonnet em um worktree isolado (ou `execute 001 haiku` para um menor), roda de novo as verificações do plano e relata se aprova, pede revisão ou bloqueia. O merge continua manual.
Antes de decidir
- Configuração
- `npx skills add shadcn/improve` e depois `/improve` (ou `/improve quick` para uma primeira rodada mais barata) dentro do repositório. O repositório também traz um manifesto de plugin para o Claude Code.
- Integrações
- Qualquer agente que suporte o formato Agent Skills; a distribuição entre subagentes e a execução em worktree foram escritas para o Claude Code. Usa `gh` para `--issues`. Lê ADRs, PRDs, CONTEXT.md e DESIGN.md quando existem, para não apontar decisões já tomadas.
- Dados e privacidade
- Somente leitura no seu código: as únicas gravações vão para `plans/`, e segredos achados na auditoria são citados por local e tipo, nunca copiados. Seu agente continua enviando código ao provedor do modelo. Licença MIT.
- Custo em escala
- Não há plano pago. O custo é o uso do modelo: até 4 subagentes simultâneos por padrão e até 8 no `deep`, mais as execuções. Não há números de tokens ou preço publicados.
- Limites
- Recusa-se a implementar qualquer coisa por conta própria. Worktrees novos não têm `node_modules`, então os executores precisam instalar dependências antes. Sem releases; 23 commits, o último em 12 de setembro de 2026.
O que é bom
- Cada achado cita arquivo e linha e é conferido de novo antes de aparecer
- Os planos trazem código colado, comandos de verificação e condições STOP
- Nunca edita o código; executores trabalham em worktrees descartáveis
- O custo se ajusta com os níveis quick, standard e deep
O que não é
- Nenhum número publicado de tokens ou de economia
- Rodadas deep disparam até 8 subagentes no seu modelo mais forte
- --issues pode publicar achados em repositórios públicos
- Sem releases marcadas; último commit em setembro de 2026
Ideal para
Equipes no Claude Code ou em outro agente compatível com skills que querem transformar a revisão de código de um modelo forte em tarefas pequenas e verificáveis, executadas por elas ou por um modelo mais barato.
Alternativas ao improve
improve: perguntas frequentes
- improve vale a pena?
- improve transforma um modelo caro em um revisor cuidadoso que escreve ordens de serviço em vez de código, que é a divisão certa, embora ninguém tenha publicado quanto essa divisão economiza. Damos nota 3.9 de 5.
- Quanto custa improve?
- Gratuito e de código aberto (MIT). O uso do modelo é cobrado pelo provedor do seu agente de código.
- Quais são as desvantagens de improve?
- Nenhum número publicado de tokens ou de economia; rodadas deep disparam até 8 subagentes no seu modelo mais forte; --issues pode publicar achados em repositórios públicos; sem releases marcadas; último commit em setembro de 2026.
- Para quem improve é indicado?
- Equipes no Claude Code ou em outro agente compatível com skills que querem transformar a revisão de código de um modelo forte em tarefas pequenas e verificáveis, executadas por elas ou por um modelo mais barato.
- Quanto custa improve para uma equipe ou em produção?
- Não há plano pago. O custo é o uso do modelo: até 4 subagentes simultâneos por padrão e até 8 no `deep`, mais as execuções. Não há números de tokens ou preço publicados.
- improve é seguro para dados da empresa?
- Somente leitura no seu código: as únicas gravações vão para `plans/`, e segredos achados na auditoria são citados por local e tipo, nunca copiados. Seu agente continua enviando código ao provedor do modelo. Licença MIT.
- Quais são as melhores alternativas ao improve?
- As alternativas mais próximas que analisamos são Superpowers, BMAD Method e Open Code Review.
Respostas verificadas em 20 de nov. de 2026.