01 Qué problema resuelve
La mayoría de los resultados flojos de Claude Code no vienen del modelo, sino de la instrucción. «Arregla el error» o «añade tests» obligan a Claude a adivinar qué archivo, qué error y qué tipo de prueba quieres. Si adivina mal, pierdes una ronda entera corrigiendo y gastas tokens en código que vas a tirar.
Prompt Improver se coloca entre tú y Claude. Antes de que Claude empiece a trabajar, comprueba si la petición tiene contexto suficiente. Si lo tiene, no hace nada más. Si no, carga una skill que explora el proyecto, revisa la conversación y te plantea preguntas con opciones concretas basadas en lo que ha encontrado (por ejemplo, los dos errores que aparecen en los últimos cambios), no preguntas genéricas.
02 Cómo funciona por dentro
Un hook que evalúa
En cada envío, un hook de tipo UserPromptSubmit añade una breve instrucción de evaluación (unos 190 tokens). Claude decide con ella si la petición es clara o vaga.
Una skill que aclara
Solo si la petición es vaga se carga la skill prompt-improver: planifica una pequeña investigación, busca en el código, formula de 1 a 6 preguntas y ejecuta con tus respuestas.
Avisos contextuales
Otras reglas se activan solo cuando aplican: sugerir modo plan en tareas complejas, lanzar servidores largos en segundo plano o pedir a los subagentes de investigación conclusiones en lugar de volcados.
Todo visible
El contexto inyectado aparece en la conversación, así que puedes ver qué ha añadido el plugin y por qué.
El diseño parte de una asimetría: un aviso innecesario cuesta unos pocos tokens que Claude ignora, mientras que una aclaración que falta cuesta una ronda completa de corrección. Por eso las reglas se activan con facilidad pero se descartan solas cuando no encajan.
03 Instalación paso a paso
-
1
Comprueba tu versión
Ejecuta claude --version. Necesitas la 2.0.22 o posterior, porque el plugin usa la herramienta de preguntas con opciones de Claude Code.
-
2
Añade el marketplace del autor
Es un catálogo de plugins alojado en GitHub; añadirlo no instala nada todavía.
-
3
Instala el plugin
Descarga el plugin y registra sus hooks y su skill.
-
4
Reinicia Claude Code
Cierra la sesión y vuelve a abrirla para que se carguen los hooks.
-
5
Verifica
Dentro de Claude Code, abre /plugin y comprueba que prompt-improver aparece como instalado.
claude plugin marketplace add severity1/severity1-marketplace
claude plugin install prompt-improver@severity1-marketplace
# reinicia Claude Code y comprueba con /plugin04 Uso diario y cómo saltártelo
No hay comandos nuevos que aprender: sigues escribiendo como siempre. Cuando la petición es clara, Claude actúa directamente. Cuando no, verás preguntas con opciones seleccionables y una opción libre para escribir tu propia respuesta.
| Empieza el mensaje con | Qué pasa |
|---|---|
| * | Se salta la evaluación para ese mensaje. Útil cuando sabes que la instrucción es corta pero suficiente. |
| / | Los comandos de barra (como /help o /compact) nunca se evalúan. |
| # | Las notas para memorizar tampoco pasan por el filtro. |
El formulario de contacto a veces no funciona, revísalo.En resources/views/contact.blade.php el botón de enviar queda deshabilitado tras un error de validación. Haz que vuelva a habilitarse cuando el usuario corrija cualquier campo y añade un test que lo compruebe.Usa la skill prompt-improver para investigar y aclarar esta tarea antes de empezar: «añadir un área privada para clientes con descarga de facturas». Pregúntame solo lo que no puedas deducir del código.05 Dónde aporta más
Equipos que empiezan con Claude Code
Las personas que aún no saben qué contexto necesita Claude aprenden por imitación: las preguntas les enseñan qué incluir la próxima vez.
Proyectos de clientes
En repositorios que no conoces bien, una pregunta a tiempo evita tocar el módulo equivocado.
Tareas de varias partes
Al detectar migraciones o refactorizaciones, sugiere planificar primero y decidir si conviene delegar en subagentes.
Ahorro de cuota
Menos intentos fallidos significa menos tokens gastados en código que acabas descartando.
06 Límites y precauciones
- ✓Añade unos 190 tokens por mensaje: en una sesión de 30 mensajes son unos 5.700 tokens, poco frente a una corrección completa, pero no es cero.
- ✓Si ya escribes prompts detallados, notarás poca diferencia; su valor está en las instrucciones cortas.
- ✓La regla de flujos de trabajo se activa por palabras clave y a veces aparece sin motivo; Claude la descarta, pero la verás en el historial.
- ✓Es un plugin de terceros que ejecuta scripts en tu máquina con cada mensaje: revisa el código del repositorio antes de instalarlo en equipos de empresa.
- ✓Si en algún momento te estorba, desactívalo desde /plugin en lugar de llenar tus mensajes de asteriscos.
Preguntas frecuentes
No. La mayoría de peticiones pasan sin cambios. Solo pregunta cuando la instrucción es realmente ambigua y, como mucho, hace seis preguntas.
Es un plugin de Claude Code basado en hooks y skills, así que funciona allí donde Claude Code cargue plugins. La forma documentada de instalarlo es con los comandos de terminal de esta guía.
Sí. Cada regla es un archivo JSON en la carpeta nudges/ del plugin. Puedes añadir una propia, por ejemplo para recordar las convenciones de tu empresa cuando aparezca cierta palabra, sin tocar código Python.
No. Reduce el coste de un mal prompt, pero un buen encargo con archivo, comportamiento esperado y criterio de terminado sigue dando mejores resultados y evita las preguntas.
Sobre el autor
Equipo editorial de appyweb
Marketing, SEO y desarrollo con IA
Especialistas de appyweb en SEO, publicidad, desarrollo web y automatización con IA.