Ponytail para Claude Code: instalación, ajustes y qué cambia
Ponytail es un prompt gratuito con licencia MIT que empuja a Claude Code hacia «el cambio más pequeño que resuelve la tarea de verdad»: ¿este código necesita existir?, ¿ya está en el repositorio?, ¿basta con la biblioteca estándar? Y solo entonces escribir. Aquí van la instalación, qué hace cada nivel y qué midió realmente el benchmark del propio autor.
Ponytail en resumen
- El núcleo es un solo prompt: skills/ponytail/SKILL.md contiene todas las reglas, y el plugin de Claude Code solo lo carga automáticamente en cada sesión.
- La instalación son dos prompts separados y en este orden: /plugin marketplace add DietrichGebert/ponytail y después /plugin install ponytail@ponytail.
- Tres niveles —lite, full (por defecto) y ultra— que se cambian con /ponytail lite o /ponytail ultra y se apagan con /ponytail off.
- No va solo de escribir menos: /ponytail-review revisa un diff, /ponytail-audit ordena un repositorio entero y /ponytail-debt recoge los atajos que has aplazado.
DietrichGebert/ponytail — README
FuenteGitHubchecked 2026-11-12
skills/ponytail/SKILL.md — the prompt itself
FuenteGitHubchecked 2026-11-12
INSTALL.md — per-agent install steps
FuenteGitHubchecked 2026-11-12
skills/ponytail-help/SKILL.md — levels, band, defaults
FuenteGitHubchecked 2026-11-12
benchmarks/results/2026-10-07-agentic.md
FuenteGitHubchecked 2026-11-12
dsh-ponytail — DeepSeek Harness port (unofficial)
Fuentedeepseekharnessplugins.comchecked 2026-11-12
Todos los comandos, nombres de nivel, claves de configuración y cifras de esta página se leyeron del repositorio original el 2026-11-12. Los comandos con barra no se traducen a propósito: un comando traducido no se ejecuta.
Datos del repositorio vía API de GitHub el 2026-11-12: 189,276 estrellas, 10,531 forks, creado el 2026-06-12, última versión v5.3.3 publicada el 2026-10-29. Las estrellas cambian a diario: es una foto fija, no una constante.
Instalar y usar Ponytail paso a paso
- 1
Saber qué estás instalando
Ponytail es un conjunto de reglas para agentes de código, publicado por Dietrich Gebert bajo licencia MIT en github.com/DietrichGebert/ponytail. El núcleo es un único archivo de prompt, skills/ponytail/SKILL.md; todo lo demás en el repositorio sirve para cargar ese prompt en un agente concreto. El plugin de Claude Code es la vía «siempre activo»: una vez instalado actúa en cada sesión y añade una insignia en la barra de estado y una serie de comandos /ponytail-*.
El README lo dice claramente: la escalera se aplica después de que el agente entienda el problema, no en su lugar. Perezoso con la solución, nunca con la lectura del código.
- 2
Comprobar los requisitos
Necesitas un Claude Code con el comando /plugin y Node.js en el PATH. El plugin ejecuta dos pequeños hooks de ciclo de vida en Node.js; sin node los skills siguen funcionando, pero cada llamada al hook imprime un inofensivo node: command not found. Usuarios de Nix y nvm: node debe estar en el PATH del shell no interactivo, no solo en el interactivo.
Comandos
node --versionSi /plugin no se reconoce, tu Claude Code es antiguo. Actualízalo y reinicia antes de seguir.
- 3
Añadir el marketplace — primer prompt
Envía esto dentro de Claude Code. El comando registra el repositorio como marketplace de plugins llamado ponytail; todavía no se instala nada.
Comandos
/plugin marketplace add DietrichGebert/ponytailEl repositorio incluye su propio .claude-plugin/marketplace.json, así que basta con owner/repo: ni URL ni ruta local.
- 4
Instalar el plugin — segundo prompt
Esto hay que enviarlo en un prompt aparte. El formato es plugin@marketplace, así que ponytail@ponytail significa «el plugin ponytail desde el marketplace ponytail». INSTALL.md lo dice sin rodeos: hacen falta dos prompts separados para que la instalación funcione, y juntarlos en un solo mensaje es la causa más habitual de que no pase nada.
Comandos
/plugin install ponytail@ponytailEn la app de escritorio de Claude Code, pestaña Code, puedes escribir los mismos dos comandos en la caja de prompt, o usar el botón + → Plugins → Add plugin para recorrer los marketplaces configurados.
- 5
Confirmar que está activo
Ejecuta /ponytail sin argumentos. Si estaba apagado, se enciende en el nivel por defecto; si ya estaba encendido, informa del nivel actual. El modo activo también aparece en el texto de arranque y de cambio de nivel, y la insignia de la barra de estado lo recuerda durante toda la sesión.
Comandos
/ponytailPrueba funcional rápida: pide algo que claramente invita a sobreingeniería, como un selector de fecha, y observa si el agente busca primero un componente Input existente y el selector nativo del navegador.
- 6
Elegir un nivel
lite construye exactamente lo pedido y nombra en una línea la opción más pequeña para que decidas tú. full es el nivel por defecto: la escalera, un test pequeño donde la lógica lo necesita y una respuesta que nombra lo omitido. ultra además cuestiona la petición antes de construir. El nivel se mantiene hasta que lo cambies o termine la sesión.
Comandos
/ponytail lite/ponytail full/ponytail ultra/ponytail offOtras dos salidas: decir stop ponytail o normal mode en lenguaje normal, o ejecutar /ponytail off.
- 7
Revisar un diff con las mismas reglas
/ponytail-review no es un linter. Lee el código que toca tu cambio, no solo el diff, e informa en este orden: correcto, seguro, aguanta carga real, testeado, rápido, sin grasa. Cada hallazgo debe decir qué hace el código, qué se rompe, cómo arreglarlo y qué pasa si no se arregla. Puedes acotar o ampliar el objetivo con palabras normales.
Comandos
/ponytail-review/ponytail-review staged/ponytail-review branchSin objetivo revisa los cambios sin commitear, o el último commit si no hay ninguno.
- 8
Auditar el repositorio y recoger la deuda
/ponytail-audit pasa las mismas comprobaciones por todo el repositorio: primero mapea puntos de entrada y flujo de datos, luego asume un nivel de carga y lo dice, y después ordena los hallazgos para que sepas qué arreglar primero. /ponytail-debt recoge en un registro los comentarios shortcut: que el agente dejó a propósito, para que «luego» no se convierta en silencio en «nunca».
Comandos
/ponytail-audit/ponytail-debtEl formato del comentario es fijo: shortcut: <el límite>, <cuándo actualizar>. Justamente por ser fijo se puede recoger.
- 9
Fijar un valor por defecto y mantenerlo al día
Hay dos formas de cambiar el nivel con el que arranca cada sesión nueva: la variable de entorno PONYTAIL_DEFAULT_MODE o el campo defaultMode de ~/.config/ponytail/config.json. El orden de resolución es variable de entorno, luego archivo de configuración, luego full. Para actualizar, activa una vez la autoactualización en /plugin → Marketplaces → ponytail, o refresca a mano y recarga los plugins.
Comandos
export PONYTAIL_DEFAULT_MODE=ultra/plugin marketplace update ponytail/reload-pluginsPara desinstalar, ejecuta primero el node scripts/uninstall.js del plugin y después /plugin remove ponytail: el script vive dentro del plugin y desaparece con él.
La escalera: qué cambia realmente Ponytail
Todo el cambio de comportamiento es una escalera de decisiones. Antes de escribir código, el agente se detiene en el primer peldaño que funciona del todo:
- 1¿Hace falta que esto exista? Las funciones, opciones y flexibilidad que nadie pidió se descartan y se nombran en una línea. Una petición vaga («hazme X») recibe la versión más pequeña que hace el trabajo central.
- 2¿Ya está en este código — un helper, un componente, un servicio, un patrón existente? Entonces se usa como lo hace el código de alrededor.
- 3¿Lo resuelve la biblioteca estándar o una función de la plataforma? Entonces se usa, salvo que el proyecto tenga su propio componente y sea mejor que el widget nativo.
- 4¿Está en una dependencia ya instalada? Entonces se usa. Nunca se añade una dependencia por unas pocas líneas.
- 5¿Cabe en una línea que se entiende de un vistazo? Una línea.
- 6Si no: el mínimo código que funciona, más un test pequeño o una autocomprobación con assert si hay ramas, bucles, un parser, dinero o seguridad.
Lo que nunca recorta
La regla es «escribe solo lo que la tarea necesita», no «escribe lo menos posible». El prompt nombra cinco cosas que se quedan en cualquier nivel:
- La validación en los límites de confianza.
- El manejo de errores que evita pérdida de datos.
- La seguridad.
- La accesibilidad.
- Lo que el usuario pidió explícitamente y la calibración que necesita el hardware real.
La otra mitad del cambio está en la respuesta. Cada respuesta termina con una o dos líneas sobre lo que se omitió o no se comprobó y el riesgo que conviene conocer. Eso es lo que hace que el diff pequeño se pueda revisar en vez de parecer sospechoso.
Todos los comandos y qué hace cada uno
Ponytail añade ocho comandos. Los cuatro últimos son los que se pierden quienes lo instalan esperando solo un estilo de escritura.
/ponytail [lite | full | ultra | off]Fijar la intensidad o apagarlo. Sin argumento, enciende Ponytail en el nivel por defecto si estaba apagado; si ya estaba, informa del nivel actual./ponytail band [on | off]Solo Claude Code: ocultar o mostrar la banda sobre el prompt. Sin argumento alterna; el nivel no cambia./ponytail band importSolo Claude Code: añade tus sesiones pasadas de Claude Code al panel local con su coste, tiempo de agente y tokens./ponytail-reviewRevisa el diff actual como el senior al que llaman cuando algo se rompe: bugs, seguridad, carga real, código arriesgado sin test, rutas lentas y qué se puede cortar. Acepta un objetivo en palabras normales: uncommitted, staged, branch o un enlace a un PR./ponytail-auditLas mismas comprobaciones en todo el repositorio, lo más importante primero./ponytail-debtRecoge en un registro los comentarios shortcut: aplazados, para que «luego» no se vuelva «nunca»./ponytail-gainMuestra el marcador de impacto medido del benchmark del autor./ponytail-helpUna tarjeta de referencia de un solo uso con niveles, skills y comandos. No cambia el modo ni guarda nada.
Otros agentes y el port para DeepSeek Harness
El prompt es portable y el repositorio incluye adaptadores para una larga lista de hosts. Los tres que más importan:
- 1Codex: codex plugin marketplace add DietrichGebert/ponytail, luego codex plugin add ponytail@ponytail y después abre /hooks en Codex, confía en sus dos hooks de ciclo de vida y empieza un hilo nuevo. En Codex los comandos son skills con espacio de nombres, se invocan como $ponytail:ponytail-review.
- 2Cursor: clona el repositorio con git clone y ejecuta node ponytail/scripts/cursor-hooks.js install. Fusiona dos hooks nativos en ~/.cursor/hooks.json y deja intactos los que ya tuvieras. El nivel se cambia enviando un mensaje normal como /ponytail lite; los subagentes nunca reciben las reglas porque el subagentStart de Cursor no puede inyectar contexto.
- 3Cualquier otro agente: npx skills add DietrichGebert/ponytail copia los seis skills en la carpeta de skills de ese agente, y copiar AGENTS.md al proyecto da las reglas permanentes sin ninguna maquinaria de plugin.
- 4Quien use DeepSeek Harness tiene un port no oficial, dsh-ponytail, cuyos skills están adaptados de este mismo repositorio bajo MIT. Es una adaptación de terceros, no algo que publique Dietrich Gebert, así que su comportamiento es responsabilidad de quien lo portó.
Las cifras publicadas y cómo leerlas
El README arranca con reducciones grandes. Todas salen de un único archivo del repositorio, benchmarks/results/2026-10-07-agentic.md, y describen una sola configuración: Claude Code headless, Opus 5.5, effort por defecto, Claude Code CLI 2.1.288, 39 tareas, 5 ejecuciones por tarea y brazo, 585 sesiones. Aquí no se reclama ninguna replicación independiente.
- 1Líneas de código: -53 % frente a sin skill, con intervalo bootstrap del 95 % de -63 % a -41 %. Tokens de salida -45 %, coste -26 %, tiempo -41 %.
- 2La corrección no se movió: en las 18 tareas con comprobaciones ocultas, Ponytail 5 pasa 87 de 90 frente a 86 de 90 sin skill. En las seis tareas de seguridad, los tres brazos pasan 30 de 30.
- 3Los tests subieron, no bajaron: un test donde la lógica lo necesita apareció en el 98 % de las celdas frente al 68 % sin skill, y los tests del propio agente atraparon el 66 % de los bugs inyectados frente al 46 %.
- 4Las respuestas se prefirieron en comparación ciega, 110 a 67 frente a la versión anterior, juzgando si la respuesta cuenta al revisor todo lo que necesita saber.
- 5La mezcla de tareas importa: 12 tickets de funcionalidad en un repositorio real de FastAPI + React, 18 tareas quirúrgicas con comprobaciones ocultas, 6 peticiones de «hazme una app pequeña» y 3 de «muéstrame un ejemplo». En todos los brazos se desactivó Bash, así que se mide lo que el agente escribe, no lo que sabe depurar.
Lee estas cifras como «el autor midió su herramienta con su propio conjunto de tareas». Es un benchmark bien documentado —tablas por tarea, intervalos y una nota específica sobre un fallo de aislamiento del primer arnés—, pero no es una auditoría de terceros ni promete los mismos porcentajes en tu repositorio.
Límites honestos antes de instalar
Ponytail es un prompt. Nada lo impone, y hay varias cosas que conviene saber antes de que entre en un repositorio de equipo.
- 1Es un proyecto de terceros, no un producto de Anthropic. Licencia MIT, mantenido por una persona; el README advierte que nunca distribuye archivos .exe ni .dll y que una copia que los traiga no es suya.
- 2Es una guía, no una puerta. El modelo todavía puede sobreconstruir, y en una tarea cuya solución mínima ya es obvia la diferencia es casi nula. La escalera paga donde el agente, si no, habría inventado estructura.
- 3La banda y el panel son solo de Claude Code, requieren Claude Code 2.1.290 o superior y no aparecen en el panel de chat de VS Code, en sesiones en la nube ni en claude -p. Los datos de sesión se quedan en local en ~/.config/ponytail/band/ salvo que configures tú el webhook opcional.
- 4Algunos hosts pierden funciones. Sin hooks de ciclo de vida el nivel no persiste entre sesiones (Gemini CLI, Qwen, Antigravity, Goose); los subagentes de Cursor nunca reciben las reglas; los adaptadores de «solo archivo de reglas» no tienen comandos.
- 5Deja estado fuera de la carpeta del plugin: un archivo de modo, ~/.config/ponytail/config.json, una copia del script de barra de estado y quizá una entrada statusLine en ~/.claude/settings.json. Si solo quitas el plugin, la insignia seguirá mostrando el último modo.
Nada de eso impide instalarlo: significa que conviene probarlo con una tarea real de tu repositorio y leerte los primeros diffs para calibrar cuánto recorta antes de llevarlo a un equipo.