Mejora Prompts Claude
Plugin que evalúa la claridad de tus prompts antes de ejecutarlos — si son claros pasan directo, si son vagos te hace preguntas inteligentes para que el resultado sea mejor desde la primera ejecución.
Qué vas a aprender
- Qué es el plugin y cómo funciona como filtro inteligente de prompts.
- Las dos capas que trabajan juntas: hook de evaluación y skill de clarificación.
- Cómo instalarlo con 3 comandos en tu terminal.
- Cómo se ve en acción — ejemplos de prompts claros vs vagos.
- Prompts para probar y ver el plugin funcionando en escenarios reales.
01 concepto
Tu filtro inteligente de prompts
Imagina un asistente que revisa tu prompt antes de que Claude lo ejecute. Si tu instrucción es clara y tiene suficiente contexto, pasa directo sin overhead. Pero si es vaga o ambigua, te hace entre 1 y 6 preguntas inteligentes antes de proceder.
Es como un arquitecto que te pide clarificar el plano antes de construir — no te frena, te ahorra retrabajo. El resultado: prompts más precisos, respuestas más útiles y hasta 31% menos tokens desperdiciados.
Cero overhead
Si tu prompt ya es claro, no agrega pasos extra. Pasa directo como si el plugin no existiera.
Preguntas inteligentes
Cuando detecta ambigüedad, hace preguntas específicas para entender exactamente qué necesitas.
31% menos tokens
Menos idas y vueltas significa menos tokens gastados — tu crédito rinde más.
02 cómo funciona
Dos capas que trabajan juntas
Hook layer — el evaluador
Un hook que intercepta cada prompt antes de que Claude lo procese. Evalúa si la instrucción es clara o vaga. Si es clara, deja pasar. Si es vaga, activa la segunda capa.
Skill layer — el clarificador
Se activa solo cuando hay ambigüedad. Ejecuta 4 fases: Research (investiga el contexto del proyecto), Questions (genera preguntas específicas), Clarify (refina el prompt con tus respuestas) y Execute (ejecuta el prompt mejorado).
Bypass prefixes
Puedes saltarte la evaluación usando * al inicio del prompt. Los comandos que empiezan con / o # se ignoran automáticamente.
La magia es que no te interrumpe cuando ya eres claro
El plugin solo interviene cuando realmente puede mejorar el resultado. Si escribes prompts detallados con contexto suficiente, ni te enterarás de que está ahí.
03 instalación
Instalar el plugin
La instalación son 3 comandos. Primero agregas el marketplace, luego instalas el plugin y finalmente reinicias Claude Code para que cargue los hooks y skills.
1. Agregar el marketplace
claude plugin marketplace add severity1/severity1-marketplace2. Instalar el plugin
claude plugin install prompt-improver@severity1-marketplace3. Reiniciar Claude Code
claudeVerificar la instalación
Usa /plugin para confirmar que el plugin está instalado. También puedes escribir un prompt vago como arregla el bug y observar cómo Claude te hace preguntas de clarificación antes de ejecutar.
Requisitos
Necesitas Claude Code 2.0.22+. Si aún no lo tienes, visita Instalar Claude Code primero.
04 paso a paso
Cómo se ve en acción
La diferencia entre un prompt vago y uno claro determina si el plugin interviene o no. Aquí dos ejemplos para que veas el contraste.
Prompt vago — el plugin interviene
Claude detecta que falta contexto y te hace preguntas antes de ejecutar.
arregla el bug → El plugin detecta ambigüedad y activa el skill de clarificación: - ¿En qué archivo o componente está el bug? - ¿Cuál es el comportamiento esperado vs el actual? - ¿Hay un error en consola o un stack trace? - ¿Se reproduce siempre o solo en ciertas condiciones? → Con tus respuestas, Claude ejecuta con contexto completo.
Prompt claro — pasa directo
Claude detecta que el prompt tiene suficiente contexto y lo ejecuta sin interrumpir.
En src/components/Header.tsx el botón de login no redirige al usuario después de autenticarse. El onClick llama a signIn() pero no tiene un redirect callback. Agrega router.push("/dashboard") después de que signIn() resuelva exitosamente.El flujo completo
Prompt
Escribes tu instrucción
Hook evalúa
¿Es claro o vago?
¿Claro?
Ejecuta directo
¿Vago?
Preguntas inteligentes
Ejecuta
Con contexto completo
05 en la práctica
Prompts para probar
Prueba estos prompts vagos a propósito para ver el plugin en acción. El plugin debería hacerte preguntas de clarificación antes de ejecutar.
Refactoriza este código
Demasiado vago — ¿qué código? ¿qué tipo de refactorización? El plugin preguntará.
refactoriza este código para que sea más limpio
Agrega tests
¿Tests de qué? ¿Unitarios, de integración? ¿A qué componente? El plugin clarificará.
agrega tests al proyecto
Mejora el rendimiento
¿De qué parte? ¿Frontend, backend, base de datos? El plugin necesitará más contexto.
la app está lenta, mejora el rendimiento
Implementa la feature
¿Qué feature? ¿Con qué especificaciones? El plugin te guiará para definirlo.
implementa la nueva feature que discutimos
Más sobre skills y plugins de Claude Code
Este plugin es uno de muchos que puedes agregar a Claude Code. Explora más en Crea Claude Skills o visita el repositorio del proyecto para ver el código fuente y contribuir.