# Improve

By **shadcn** · Habilidades

Una habilidad de agente que audita cualquier base de código con tu modelo más capaz y escribe planes de implementación autocontenidos para que los ejecuten modelos más económicos (o humanos).

- Source: https://github.com/shadcn/improve
- Repository: https://github.com/shadcn/improve
- Install: `npx skills add shadcn/improve`
- Tags: agent, open-source, cli, code-review, planning, multi-agent, mit-license, agentic
- Pricing: free
- Upvotes: 0

## Features

- Audita una base de código y escribe planes ejecutables sin tocar el código fuente
- Subagentes paralelos en nueve categorías con evidencia de file:line
- Pasada de autoverificación que vuelve a leer las ubicaciones citadas para eliminar falsos positivos
- Tabla de hallazgos ordenada por apalancamiento para que elijas
- Planes autocontenidos con puertas de verificación y condiciones STOP
- execute despacha un modelo más económico en un worktree aislado y lo revisa
- Publicación opcional de planes como issues de GitHub

---

Improve es una Agent Skill (instálala con `npx skills add shadcn/improve`) que audita cualquier base de código y escribe planes de implementación para que otros agentes los ejecuten; nunca escribe código fuente por sí misma. La idea es invertir tu modelo más capaz donde la inteligencia se multiplica: mapear el repositorio, evaluar qué vale la pena hacer y redactar la especificación. El plan es el producto.

Una ejecución mapea el repositorio y sus comandos exactos de build, test y lint, luego despliega subagentes paralelos en nueve categorías: correctness, security, performance, test coverage, tech debt, dependencies, DX, docs y direction. Cada hallazgo incluye evidencia de file:line, impacto, esfuerzo y confianza. Después vuelve a leer cada ubicación citada para eliminar falsos positivos antes de mostrarte una tabla ordenada por apalancamiento. Los hallazgos seleccionados se convierten en planes markdown autocontenidos escritos para el ejecutor más débil razonable: contexto incrustado, puertas de verificación comprobables por máquina y condiciones STOP explícitas. `improve execute` despacha un ejecutor más económico en un worktree aislado y revisa el diff como un tech lead, mientras que `reconcile` mantiene el backlog actualizado con el tiempo. Funciona en cualquier agente que soporte el formato Agent Skills y puede publicar los planes como issues de GitHub.

## FAQ

### ¿En qué se diferencia Improve de un agente de programación?

Deliberadamente nunca implementa nada. Usa un modelo costoso para entender el repositorio y escribir planes rigurosos, luego delega la ejecución a modelos más económicos o a humanos, y la decisión de hacer merge siempre es tuya.

### ¿Qué contiene un plan?

Cada plan es autocontenido: rutas de archivo exactas, fragmentos del código en su estado actual, los propios comandos de test y lint del repositorio como puertas de verificación, una lista de elementos fuera de alcance y condiciones STOP para cuando la realidad no coincida con el plan.

### ¿Qué agentes pueden ejecutarlo?

Cualquier agente que soporte el formato Agent Skills. Instálalo con npx skills add shadcn/improve.

---
[View on Analog](https://analoghq.ai/es/shadcn/skills/improve)