Use improve para auditar uma base de código e emitir só plans

Para quem

Se quiser que um modelo mais forte veja a base de código com clareza, decida o que vale a pena, escreva uma especificação e passe a execução a um modelo mais barato, improve encaixa. O texto oficial diz: auditar qualquer base de código e escrever planos de implementação para outros agentes. A habilidade não implementa nada; o plano é o entregável.

A primeira passagem deve parar no plano. Não altera o código-fonte. A única escrita permitida é plans/. Se quiser que a mesma habilidade altere código de negócio diretamente, escolheu a errada. Quem executa só deve alterar um worktree descartável; a fusão é sempre sua. Esta página não dá comandos de worktree; não os invente.

Os textos públicos dizem que funciona em qualquer agente que suporte o formato Agent Skills. Os planos são markdown comum que um agente ou uma pessoa podem continuar. Nenhum cliente concreto é nomeado. Não acrescente uma lista de produtos nem escreva suporte exclusivo.

Primeira tentativa em 3 minutos

Use só este comando oficial de instalação:

npx skills add shadcn/improve

Pré-requisito: tem uma base de código real para auditar e consegue executar npx nesse projeto. Depois de instalar, prepare-se para usar /improve. Não invente um segundo método de instalação.

A instalação escreve ficheiros de habilidade. Antes de executar, confirme que o diretório atual é o repositório a auditar. Depois do comando, faça primeiro uma verificação que não escreva plano: confirme que o agente reconhece /improve e consegue repetir «só escrever plans/, não alterar o código-fonte». Esse é o sinal observável de sucesso da instalação.

Uma execução real de /improve faz uma auditoria completa, ordena prioridades e escreve planos em plans/. Confirme que aceita novos ficheiros de plano markdown e depois:

/improve

Sinal de sucesso: o código-fonte não foi alterado por ela, e em plans/ há achados priorizados e planos de implementação. O material público não indica outros comandos slash nem garante a regra de nomes dos ficheiros de plano.

Casos de uso

Caso 1: auditoria completa do repositório atual e um plano. Com a habilidade instalada, execute /improve e deixe terminar auditoria → achados priorizados → plano. Leia primeiro o markdown em plans/ e depois decida se passa a outra pessoa. Este é o fluxo principal. Os textos públicos não dão uma grelha de dimensões de auditoria; não finja já saber que ficheiros serão inspecionados.

Caso 2: passar o plano a outro agente ou pessoa. O texto oficial diz que o plano é markdown comum que qualquer um pode retomar; esta habilidade continua sem implementar. Quem executa só altera um worktree descartável; você conclui a fusão. Confirme primeiro o âmbito do plano e depois entregue. Esta página não dá comandos de execução nem de fusão. Este caso só cobre «entregar o plano e controlar a fusão».

Limites de uso

A habilidade nunca altera o código-fonte. As escritas vão só para plans/. Não a trate como refatoração automática nem reparo automático. Também não a deixe executar o plano na área de trabalho principal.

A instalação é só npx skills add shadcn/improve. A página não nomeia clientes, só o formato Agent Skills. Não acrescente marketplace nem copie um diretório skills que não foi dado.

/improve escreve ficheiros de plano; confirme antes de executar. O material público não tem passos de desinstalação e não transforma «modelo mais forte / modelo mais barato» em identificadores de modelo obrigatórios.

Endereço do repositório:

https://github.com/shadcn/improve