Open source · Agent Skills

Skills para el trabajo que rodea al código

Escribir el código nunca fue la parte lenta. Lo lento es todo lo que lo envuelve: los doce comentarios que dejó un bot de revisión, la pila de cuatro ramas que no mergea, la decisión que tomaste hace tres semanas y ya no sabes defender. Estas cuatro skills escriben esos procedimientos una vez, con sus bordes afilados incluidos.

Qué resuelven

Cuatro problemas concretos

Los agentes son buenos con el código y torpes con el resto, porque el resto no es una habilidad: es un montón de procedimientos pequeños con bordes afilados. Cada uno se aprende en una tarde y se olvida el viernes.

gh + jq

La review volvió con doce comentarios

Responderlos significa una pestaña del navegador, doce cajas de texto y mucho scroll. Y el agente que escribió el código, el que sabe si el comentario 7 tiene razón, no está en esa pestaña contigo.

Responde, comenta y resuelve hilos desde la terminal. El detalle que lo hace necesario: las respuestas y las resoluciones viven en dos APIs distintas de GitHub que no se ponen de acuerdo casi en nada, ni en la forma del ID ni en el nombre del propio revisor. En un PR real, REST reportaba «Copilot» para el mismo comentario que GraphQL llamaba «copilot-pull-request-reviewer».

answer-reviewersVer la skill
git, y gh para derivar la cadena

La pila tiene conflictos y todas las ramas están en rojo

Cuatro ramas encadenadas y GitHub dice que hay conflictos que resolver. Parecen cuatro problemas y es uno: solo el primer punto sucio de la cadena es real, y resolverlo cambia todos los resultados que vienen después.

Toda la interfaz es un número de PR, el que sea de la pila. Reconstruye la cadena, encuentra el primer punto que está atrasado o en conflicto, lo resuelve y sigue. Distingue los dos modos en que una pila se propaga, merge del padre hacia abajo y rebase, que importa más de lo que parece: en un rebase, `--ours` significa lo contrario que en un merge.

resolve-stacked-conflictsVer la skill
git, y gh para leer PRs

Nadie se acuerda de por qué

El código dice qué construiste. Nunca dice qué más había sobre la mesa ni por qué perdió. Seis meses después el esquema parece arbitrario y la lógica de reintentos parece paranoica.

Lee la sesión, el diff y el hilo del PR, y dibuja cada bifurcación en una página HTML: el camino tomado en línea sólida, los descartados en discontinua y con el motivo por el que perdieron. Una decisión reconstruida por inferencia se marca como tal en vez de disfrazarse de hecho registrado.

decision-recapVer la skill
Docker

La conversión del PDF salió mal

Columnas entrelazadas, encabezados que faltan, tablas colapsadas, un libro escaneado que produce un archivo vacío. Todas parecen «la herramienta es mala» y cada una tiene una causa distinta.

Quince recetas que empiezan por cómo se ve la salida rota, no por qué tipo de PDF es. Después parte el resultado en un árbol por capítulos y comprueba que los enlaces siguen funcionando. Todo corre dentro de Docker, así que no se instala nada en tu máquina.

pdf-to-markdownVer la skill
Instalación

Treinta segundos

El instalador las escribe en tu repositorio como archivos normales que te pertenecen y puedes editar. Nada se actualiza a tus espaldas.

Todas

npx skills@latest add abr4xas/skills

Solo la que quieras

npx skills@latest add abr4xas/skills \
  --skill answer-reviewers

Para traer la última versión cuando tú quieras, npx skills update. Funcionan con cualquier agente que lea el formato de Agent Skills, no solo con Claude Code: si tienes dudas sobre qué formato lee cada editor, está en la comparativa de AGENTS.md, CLAUDE.md, rules y skills.

Si escribes las tuyas

La forma de una buena skill

Las cuatro siguen las mismas reglas, y son la parte más reutilizable de todo esto: valen para cualquier skill, no solo para estas.

  • 00

    Un número por interfaz

    `/resolve-stacked-conflicts 5827` y ya. Todo lo demás se deriva en tiempo de ejecución, así que no puede quedarse obsoleto entre una ejecución y la siguiente.

  • 01

    Escribe los bordes, no el camino feliz

    El camino feliz el agente ya lo adivina. Los detalles con filo (los dos logins, el `--ours` invertido, el tope de 100 hilos que no avisa) son la razón entera de que el documento exista.

  • 02

    Dale un denominador

    «Terminado» tiene que ser contable contra algo: cada comentario respondido, cada archivo atribuido. Si no, «terminado» significa «me aburrí».

  • 03

    Vuelve para las decisiones humanas

    Qué rama hija seguir, qué conflicto es en realidad una decisión de producto. Esas no le tocan al agente.

Open source

Fórkalas y hazlas tuyas.

Son pequeñas, se combinan entre sí y funcionan con cualquier agente. Están bajo licencia MIT, así que puedes cambiarlas sin pedir permiso.