Devolutions/IronRDP

Audita un archivo AGENTS.md o CLAUDE.md línea por línea para detectar instrucciones incorrectas, desactualizadas, descubribles, duplicadas o sin contenido, y propone el archivo podado. Úsalo cuando te pidan revisar, podar, reducir o limpiar uno.

¿Qué es IronRDP?

Esta habilidad permite auditar y podar sistemáticamente los archivos AGENTS.md o CLAUDE.md de un repositorio. Aplica las pruebas definidas en `agents-md` para clasificar cada bloque de instrucciones en categorías como **Wrong** (incorrecto), **Stale** (desactualizado), **Discoverable** (descubrible), **Duplicated** (duplicado), o **Content-free** (sin contenido). También identifica reglas que **nunca han sido una convención** (porque nadie las sigue y el mantenedor no las decidió), así como contenido **fuera de lugar** que pertenece mejor a otra skill o archivo de carga permanente. El análisis se realiza contrastando las afirmaciones contra la configuración real de herramientas (por ejemplo, generadores de changelog o CI), el árbol de archivos, el historial de PRs y las skills instaladas. El resultado es un reporte con una tabla de veredictos respaldados por evidencia, seguido del archivo podado propuesto, una lista de lo que se movió a otra skill o a un AGENTS.md anidado, y lo que requiere decisión humana. La auditarse no aplica cambios automáticamente a menos que se solicite expresamente. Está diseñada para plataformas como Claude Code, Cursor, Codex, etc., que utilizan AGENTS.md o CLAUDE.md como archivos de instrucciones para el agente. El usuario debe invocar esta habilidad pidiendo explícitamente una revisión, poda, reducción o limpieza del archivo correspondiente.

Compatible con✓Claude Code~Codex CLI~Cursor

npx skills add https://github.com/Devolutions/IronRDP/tree/HEAD/.agents/skills/agents-md-review

Documentación

Revisión de AGENTS.md

Los veredictos aplican la prueba de agents-md: más de una ronda de retroalimentación barata para descubrir y corregir, y declarada en ninguna skill o archivo de carga permanente.

Verificar, luego clasificar

Revisa el archivo tal como se te da e indica qué revisión es. Verifica cada bloque contra la realidad antes de juzgarlo; basta una pieza de evidencia por veredicto.

Ejemplos y formatos contra la herramienta que los consume (generador de changelog, herramientas de lanzamiento, workflows de CI): Wrong. Leer la configuración de la herramienta es suficiente; lo que renderizaría incorrectamente está mal aunque la salida errónea no se haya publicado.
Listados contra el árbol y la rama predeterminada remota: Stale.
Convenciones reclamadas contra el historial de PRs fusionados: Never a convention cuando nadie la sigue y el mantenedor confirma que nadie la decidió. Un mantenedor puede estar introduciendo la regla deliberadamente, y un committer humano no prueba nada sobre quién la decidió, por lo que una regla no seguida sobre la que el mantenedor no se ha pronunciado va a la lista de decisiones humanas.
Reglas contra las skills instaladas y los archivos de carga permanente: Duplicated.
Todo lo demás contra la prueba anterior: Discoverable, Content-free, o Plain command.
Un puntero de carga permanente a una guía larga: Misplaced; pertenece a la skill que lo necesita.

Un bloque puede obtener más de un veredicto, cada uno con su propia evidencia; encabeza con el que no requiere confirmación humana, para que la poda pueda comenzar antes de que el mantenedor responda.

También busca lo que falta: política que la organización aplica en otros lugares (reglas de archivos de intención, convenciones de escritura, marcadores de comentarios), diseños no estándar sin puntero, y un AGENTS.md sin un enlace simbólico hermano CLAUDE.md. agents-md/references/before-after.md es la respuesta trabajada de un repositorio; vuelve a verificar cada fila contra el repositorio que tienes delante, nunca la pegues.

Reporte

| Bloque | Veredicto | Evidencia |
|---|---|---|
| `Issue: #456`, `Issue: N/A` como pies de página válidos | Wrong, Never a convention | `cliff.toml` convierte cada valor de `Issue:` en un enlace de Jira; el mantenedor confirma que ninguno fue decidido |
| Las pruebas ejecutan el binario CLI, no la biblioteca; ver `testsuite/AGENTS.md` | Keep | rehacer un conjunto de pruebas a nivel de biblioteca es más de una ronda; ninguna skill lo establece |

Luego propón el archivo podado completo, lista lo que se trasladó a una skill o a un AGENTS.md anidado, y lista lo que necesita una decisión humana. No apliques los cambios a menos que se te pida.