/claude-api prompt-audit: tu CLAUDE.md y tus skills, optimizados para Opus 5.5

TL;DR Ejecuta /claude-api prompt-audit en la raíz del proyecto, lee el informe y aplica solo los cambios que te convenzan: no toca ningún archivo por su cuenta. En un proyecto de prueba lleno de mayúsculas lo reescribió casi todo. En mi repo de 14 skills propuso 11 cambios pequeños, y el más importante no era de estilo: una ruta que ya no existía.

Esta semana se ha hecho viral un tweet de Lance Martin (más de 200.000 visualizaciones) que recomienda /claude-api prompt-audit para Opus 5.5: revisa tus skills, tu CLAUDE.md y tus prompts, y elimina los patrones que frenan a los modelos actuales. El comando existe y funciona. Pero no elimina nada, y no es nuevo: llegó en la v2.1.221. Lo he ejecutado tres veces en la v2.1.282 con Opus 5.5 para ver qué hace.

Qué hace

/claude-api es una skill que viene de serie con Claude Code, y prompt-audit es uno de sus subcomandos. Al lanzarlo, Claude carga una guía interna (shared/prompt-audit.md, unos 39 KB) y la sigue en orden:

1. Hace inventario de todo lo que le llega al modelo como texto: CLAUDE.md, SKILL.md, reglas, descripciones de herramientas y, si tu código llama a la API, el que construye las peticiones.
2. Si hay historial de git, mira con git blame cuándo y por qué entró cada línea enfática.
3. Pasa cada instrucción por una pregunta: ¿esto el modelo ya lo sabe?
4. Te entrega un informe con cada hallazgo (archivo:línea, el texto exacto, el patrón, por qué sobra y un nivel de confianza) y un diff con los cambios propuestos.

La guía es tajante con lo último: propone y nunca aplica sin tu consentimiento. Solo edita archivos si tu petición lo pide de forma explícita. En mis tres ejecuciones no tocó ninguno (en la del repo, además, le había quitado los permisos de edición).

Qué marca

El motivo, según la propia guía: los modelos actuales siguen las instrucciones de forma más literal que aquellos para los que se escribió ese texto. Una regla en mayúsculas pensada para un modelo que la ignoraba ahora se aplica de más. Y cuando todo es crítico, nada lo es.

Con Opus 5.5 la guía añade dos matices por nombre. El thinking está siempre activo, así que una frase que pide pensar más, o menos, ya no controla nada: el único mando es el effort. Y pedir que el razonamiento aparezca en la respuesta puede provocar un rechazo (reasoning_extraction).

Qué no toca

La guía trae una lista de lo que no se marca aunque coincida con un patrón. Es lo que separa esto de "haz tu prompt más corto":

• El contexto. El producto, el entorno, el porqué de cada regla. Es lo único que el modelo no puede sacar de otro sitio.
• Los pasos exactos de operaciones delicadas. Comandos destructivos, despliegues, flujos de autenticación.
• Las prohibiciones que siguen haciendo falta. Si el fallo se reproduce con el modelo actual, la regla se queda.
• Un archivo limpio. Si no encuentra nada, no cambia nada.

Lo que medí

Tres ejecuciones con claude -p y Opus 5.5. El coste es total_cost_usd a tarifa de lista.

En el proyecto de prueba encontró todo lo que había puesto a propósito, incluida la contradicción entre "respuestas de menos de 3 líneas" y "explica cada cambio con todo el razonamiento". Y dejó intacta la única regla con motivo: "no ejecutes los tests sin preguntar".

En mi repo el resultado fue otro. Ni un "piensa paso a paso", ni mayúsculas en cadena. El único hallazgo de confianza alta fue una ruta de validación que apuntaba a una carpeta que ya no existe: no es un vicio de estilo, es un paso roto. El resto fueron referencias que ya no cuadraban, una regla que la frase siguiente anulaba y un "el tiempo y los tokens no importan" que en Opus 5.5 empuja a comprobar de más. Todas mis puertas de aprobación antes de publicar se quedaron donde estaban.

En el global, su propuesta principal fue que mis reglas más duras (nada de commits sin mi confirmación) no dependan solo del texto: pasarlas a una regla ask de permisos en settings.json.

Cómo usarlo

1. Lánzalo en la raíz del proyecto.

/claude-api prompt-audit

Sin argumentos audita todo el directorio de trabajo. Tu ~/.claude/CLAUDE.md no entra.

2. O dale un archivo concreto.

/claude-api prompt-audit ~/.claude/CLAUDE.md

Con una ruta, el alcance es ese archivo y nada más. En mi prueba dejó fuera el CLAUDE.md del proyecto aunque tenía vicios a la vista, y solo lo mencionó al final.

3. Lee el informe antes que el diff. Arriba aparecen sus suposiciones (qué modelo toma como objetivo y qué archivos entran) y los hallazgos llegan ordenados por confianza. Los de confianza baja se quedan en el informe y no llegan al diff.

4. Aplica solo lo que te convenza. El diff llega en un archivo aparte o dentro del propio informe, y eliges qué partes aplicar. No lo comprueba: sin evals, cada cambio es una hipótesis, y el propio informe te lo dice y te sugiere una prueba antes y después.

Cuándo pasarlo

Cada vez que cambies de modelo. La guía lo resume así: los prompts son artefactos de un modelo concreto, y una línea que sostenía algo en una generación sobra en la siguiente. Si tu CLAUDE.md es anterior a Opus 5, los consejos de Anthropic para Opus 5 ya pedían borrar parte.

No lo confundas con /doctor: ese busca un CLAUDE.md inflado y las líneas que Claude ya deduce del código. prompt-audit busca instrucciones escritas para un modelo que ya no usas. Si tu CLAUDE.md está lleno de cosas que Claude infiere solo, límpialo antes, y si escribes skills, las 5 reglas de Anthropic apuntan en la misma dirección.

Documentación oficial: Commands: /claude-api · Skills: bundled skills

Requisitos

• Claude Code v2.1.221 o posterior. Comprobado en la v2.1.282 con Opus 5.5, el 25 de septiembre de 2026.