Mejorar Skills

---
name: mejorar-skills
description: Consolida las retros del flujo con agentes y las señales objetivas (fallas de CI en ramas de agentes, reverts) y propone ajustes a las skills en un PR que revisa una persona. Nunca edita las skills sin PR ni afloja controles. Usar con "/mejorar-skills", "¿qué aprendimos de las últimas corridas?", "ajustá las skills con el uso" o en la corrida semanal programada.
---

# Mejorar las skills con el uso

Las skills aprenden de su uso, pero **no se reescriben solas**: esta skill propone, una persona decide. Un ajuste sin control se ajusta a un solo caso, alarga las skills y, sobre todo, tiende a sacar los controles que frenan al agente, que son justo lo más valioso.

## 1. Juntar las señales

```bash
.claude/skills/mejorar-skills/senales.sh [días]
```

Trae las retros nuevas de la rama `agentes/retros` (desde `consolidado.md`; un archivo por retro, con `skill_sha` para saber con qué versión de la skill se hizo, y `modelo` y `rol` para saber quién la hizo) y las señales objetivas: fallas de CI en ramas `claude/` agrupadas por workflow, y reverts. Las señales objetivas pesan más que las retros: el agente no ve sus propios puntos ciegos.

Si no hay nada nuevo, decilo y terminá.

## 2. Agrupar por patrón

Para cada patrón: qué pasó, en qué casos (links), y qué skill o script lo habría evitado. Un patrón es algo que se repite o que fue grave; una anécdota no es un patrón.

Agrupá los desvíos y hallazgos por `modelo` y por `rol`. Si un mismo modelo falla repetido en un tipo de issue (`tipo:` o `area:`), es un caso para la regla de ruteo de `orquestar` (qué issues van a Haiku y cuáles a Sonnet): se propone en el PR, sin aflojar el escalado de `mapa.py` ni el revisor. Las retros con `modelo: desconocido` o `rol: sesion` no entran en esa comparación.

## 3. Decidir qué proponer

Reglas, en este orden:

1. **Al menos dos casos, o uno grave.** Grave: un bug que llegó a la revisión o a producción, una regla de negocio rota, datos o dinero en riesgo.
2. **Nunca quitar ni aflojar** reglas de Autonomía (`AGENTS.md`), aprobaciones, verificaciones ni el "no mergea / no aprueba". Si un control frena seguido sin motivo, se plantea como **pregunta para el equipo** en el PR, no como cambio.
3. **Script antes que texto.** Si se puede verificar mecánicamente (un check de CI, un control en `verificar.py` o `preparar.sh`), eso; una instrucción más en Markdown es el último recurso. Las instrucciones son lo que el agente se saltea.
4. **Largo máximo:** ninguna `SKILL.md` pasa de 120 líneas. Si un ajuste no entra, hay que sacar o pasar a script otra cosa.
5. **Un cambio por patrón**, con su motivo y los casos que lo justifican.
6. **Lecciones:** lo que sirve pero no alcanza para cambiar una skill (un caso, o algo que no se puede verificar con un script) va a `docs/agentes/lecciones.md`, en el mismo PR. Es lo único de las retros que leen los demás agentes: nunca leen retros crudas. Máximo 40 líneas (lo controla `check-docs.py`): si no entra, sacá la lección más vieja o la que ya pasó a una skill.

## 4. Proponer en un PR

Rama `claude/<n>-mejorar-skills-<fecha>` (con un issue `tipo:task`), base la rama troncal de trabajo. El cuerpo del PR:

```markdown
## Patrones encontrados
| Patrón | Casos | Ajuste propuesto |
## Preguntas para el equipo
(controles que frenan seguido; nada de esto se cambia en este PR)
## Descartado
(anécdotas o casos que no alcanzan las reglas)
```

Mostrá el borrador del PR antes de abrirlo y esperá un "sí".

## 5. Marcar lo consolidado

Abierto el PR, marcá hasta dónde consolidaste con el commit que imprimió `senales.sh` ("consolidar hasta"):

```bash
.claude/skills/mejorar-skills/retro.sh --consolidado <commit> <link al PR>
```

Escribe `consolidado.md` en la rama `agentes/retros`; la próxima corrida empieza desde ahí. Usá ese commit y no la punta actual: así no se saltean retros que llegaron mientras armabas el PR.

## Programarla

Para que corra sola (por ejemplo, los lunes), usá una tarea programada que ejecute `/mejorar-skills`. Igual termina en un PR para revisar: programarla no le da permiso para mergear.