# Ponytail Debt

> Harvest every `ponytail:` comment in the codebase into a debt ledger, so the deliberate shortcuts and deferrals ponytail leaves behind get tracked instead of rotting into "later means never". Use when the user says "ponytail debt", "/ponytail-debt", "what did ponytail defer", "list the shortcuts", "ponytail ledger", or "what did we mark to do later". One-shot report, changes nothing.

Source: https://skillsagentes.com/skills/dietrichgebert/ponytail/ponytail-debt
Repository: https://github.com/DietrichGebert/ponytail
Author: dietrichgebert
License: MIT
Updated: el mes pasado
Context cost: 97 tok installed, 426 tok once triggered, 426 tok with every bundled file
Bundle: 1 file, 2 KB
Permissions requested: none declared

## Install

```bash
npx -y skills add DietrichGebert/ponytail --skill ponytail-debt --agent claude-code
```

## What it does

- Recolecta todos los comentarios `ponytail:` del repo (grep de marcadores) en un ledger único de deuda técnica.
- Cada fila junta archivo:línea, qué se simplificó, el techo (ceiling) y el disparador de mejora (upgrade), extraídos del propio comentario.
- Marca con `no-trigger` cualquier comentario `ponytail:` que no nombre techo ni disparador, porque son los que se pudren en silencio.
- Termina con `<N> markers, <M> with no trigger` o "No ponytail: debt. Clean ledger." si no encuentra nada.

## Use it when

- Recolectar los atajos que ponytail dejó marcados como deuda pendiente.
- Preguntar qué se difirió o listar los shortcuts del repo.

## What triggers it

- "/ponytail-debt"
- "qué deuda dejó ponytail"
- "lista los shortcuts marcados en el código"

## Before you install

- Ninguno: solo lee y reporta ("Reads and reports only, changes nothing"); si se pide, escribe el ledger a un archivo como PONYTAIL-DEBT.md.

## Files

- SKILL.md — 2 KB

## SKILL.md

Reproduced verbatim from DietrichGebert/ponytail under MIT. This section is the upstream document and is in English.

Every deliberate ponytail shortcut is marked with a `ponytail:` comment naming
its ceiling and upgrade path. This collects them into one ledger so a deferral
can't quietly become permanent.

## Scan

Grep the repo for comment markers, skipping `node_modules`, `.git`, and build
output:

`grep -rnE '(#|//) ?ponytail:' .`  (add other comment prefixes if your stack uses them)

Each hit is one ledger row. The comment prefix keeps prose that merely mentions
the convention out of the ledger.

## Output

One row per marker, grouped by file:

`<file>:<line>, <what was simplified>. ceiling: <the limit named>. upgrade: <the trigger to revisit>.`

The convention is `ponytail: <ceiling>, <upgrade path>`, so pull the ceiling
and the trigger straight from the comment. Want an owner per row too? add
`git blame -L<line>,<line>`.

Flag the rot risk: any `ponytail:` comment that names no upgrade path or
trigger gets a `no-trigger` tag, those are the ones that silently rot.

End with `<N> markers, <M> with no trigger.` Nothing found: `No ponytail: debt. Clean ledger.`

## Boundaries

Reads and reports only, changes nothing. To persist it, ask and it writes the
ledger to a file (e.g. `PONYTAIL-DEBT.md`). One-shot. "stop ponytail-debt" or
"normal mode" to revert.

---

Skills Agentes — https://skillsagentes.com/skills/dietrichgebert/ponytail/ponytail-debt