🔍 Descubre qué hace la skill y qué nunca hace
audit-ablacao y una skill — un archivo de
procedimiento que guardas en una carpeta y que Claude Code carga cuando lo llamas por su nombre o cuando su descripción
coincide con tu solicitud. Lo que hace esta skill: lee tu CLAUDE.md (el del proyecto y el global, en ~/.claude/CLAUDE.md), tus otras skills, los hooks
(comandos que Claude Code ejecuta automáticamente en ciertos momentos, antes o después de que se ejecute una herramienta) y el
settings.json (el archivo de configuración del propio Claude Code: permisos, variables de entorno, hooks). Después clasifica cada instrucción, decide qué hacer con ella y entrega un informe de 10 secciones.
Lo que ella nunca hacer: editar, mover, borrar, sobrescribir config o hacer commit. Eso es intencional, no es una limitación. Una auditoría que ya empieza a cambiar cosas es una auditoría en la que no confías — pierdes la oportunidad de disentir antes del daño y pierdes la línea de base para medir si el recorte fue bueno. Aquí, aplicar los cambios es una solicitud aparte, tuya, en otra sesión.
🆕 Cuatro palabras antes de continuar
- Skill: archivo
SKILL.mdcon un procedimiento nombrado, cargado bajo demanda por el agente. - Hook: comando que Claude Code ejecuta solo ante un evento (antes/después de una herramienta, al cerrar la sesión).
- settings.json: configuración del harness — permisos, variables de entorno y registro de hooks.
- Activador (trigger): las frases de la descripción de la skill que hacen que el agente decida cargarla sin que tú la llames por su nombre.
✓ Lo que hace la skill
- ✓Le
CLAUDE.mddel proyecto y el global - ✓Lee las skills, los hooks y el
settings.json - ✓Clasifica cada instrucción (contexto, regla de protección, criterio, verificación, microgestión, redundancia, legado…)
- ✓Decide KEEP · SIMPLIFY · MOVE · MERGE · TEST · REMOVE
- ✓Audita una skill a la vez
- ✓Entrega el informe de 10 secciones
✗ Lo que nunca hace
- ✗Editar cualquier archivo de config
- ✗Mover o renombrar skills
- ✗Borrar líneas de tu
CLAUDE.md - ✗Sobrescribir
settings.jsono hooks - ✗Ejecutar
git, hacer commits ni enviar nada - ✗Opinar sobre un archivo que no pudo leer
Qué observar: las flechas continuas llegan hasta el informe: ese es el camino que recorre la skill. La última flecha es discontinua y está cortada por una X: aplicar no forma parte de su trabajo. Fíjate también en que la columna de la izquierda dice «configuración (sin cambios)»: los archivos entran y salen exactamente iguales.
Vecindad: no confundas las dos
Se encarga de la memoria guardada de la sesión: qué se anotó, qué es ruido, qué debería olvidarse.
Se encarga de la configuración del agente: CLAUDE.md, skills, hooks, settings.json.
📦 Instala la skill
Instala una skill y copia un archivo a una carpeta. Nada más. Dos opciones: global (se aplica a todos tus proyectos,
está en ~/.claude/skills/) o por proyecto (solo aplica allí, queda en
.claude/skills/ dentro del repositorio). Elige uno de los dos bloques siguientes y ejecútalo en la terminal.
Ruta A — instalación global
Disponible en cualquier proyecto que abras con Claude Code.
git clone https://github.com/inematds/audit-ablacaocc.git mkdir -p ~/.claude/skills/audit-ablacao cp audit-ablacaocc/SKILL.md ~/.claude/skills/audit-ablacao/SKILL.md
Ruta B — instalación por proyecto
Ejecútalo dentro de la carpeta del proyecto. Cambia <caminho> por el lugar donde clonaste el repositorio.
mkdir -p .claude/skills/audit-ablacao cp <caminho>/audit-ablacaocc/SKILL.md .claude/skills/audit-ablacao/SKILL.md
Verifica que lo instalaste
Dos comprobaciones: el archivo existe en el disco y el agente puede ver la skill.
# 1. o arquivo esta no lugar? ls ~/.claude/skills/audit-ablacao/ # esperado: SKILL.md # 2. o cabecalho da skill esta legivel? head -4 ~/.claude/skills/audit-ablacao/SKILL.md # esperado: uma linha "name: audit-ablacao"
Paso 3: reinicia la sesión de Claude Code. Las skills
se leen al iniciar; mientras no reinicies, la skill existe en el disco, pero no existe para el agente. Después de reiniciar,
audit-ablacao debe aparecer en la lista de skills disponibles.
💡 ¿Global o por proyecto? La diferencia práctica
La skill del proyecto se versiona junto con el codigo: va junto con el repositorio, entra en el pull request y un colega revisa el procedimiento como revisa cualquier otro archivo. Y no se filtra a tus otros proyectos: ya no se convierte en una línea más compitiendo por atención donde no tiene sentido.
La global y conveniente para la herramienta que usas en todas partes. Regla simple: el procedimiento del equipo va al proyecto, la herramienta personal va a la configuración global.
🎯 Elige el alcance adecuado
Alcance y el conjunto de archivos que le pides a la skill que audite. Si no lo dices, te pregunta, y la respuesta cambia la calidad del informe más que cualquier otra elección de este módulo. Tres alcances que vale la pena considerar, cada uno en su momento:
| Alcance | Dónde vive | Cuándo ejecutarlo |
|---|---|---|
| Global | ~/.claude/ | Cada ~6 meses, y sobre todo con cada lanzamiento importante de modelo |
| Un proyecto | ./CLAUDE.md + ./.claude/ | Cuando el CLAUDE.md de él supera ~150 líneas |
| Un conjunto de skills | Algunas carpetas de skills/ | Cuando 3+ skills compiten por el mismo disparador |
¿Por qué no auditar todo de una vez? Porque el costo aparece en el informe, no en tu tiempo. Un alcance amplio significa muchas instrucciones leídas con poca atención por instrucción: las tablas quedan superficiales, la columna «Cómo probar» se vuelve genérica, y Top 10 mezcla cosas de contextos que no se pueden comparar. Un alcance acotado da lo contrario: cada recomendación con un fragmento citado, un riesgo identificado y una prueba que puedes ejecutar hoy.
✓ Alcance bien elegido
- ✓"Audita solo el
CLAUDE.mdglobal" — un archivo, analiza línea por línea - ✓"Audita las 4 skills de video de este proyecto" — alcance con límites claros
- ✓Un ámbito por sesión, un informe por ámbito
✗ Alcance que arruina el informe
- ✗"Audita todo" — global + 12 proyectos + 40 skills en la misma pasada
- ✗Alcance vago («mi configuración») que obliga a la skill a adivinar qué leer
- ✗Mezclar dos proyectos: las redundancias señaladas no existen realmente
📑 Lee el informe de 10 secciones
El informe tiene un orden fijo, y el orden es un argumento: empieza con el diagnóstico, pasa por la evidencia, llega a la propuesta y termina con el plan de prueba. Leerlo en orden es seguir el razonamiento. Cada sección te exige algo — abajo, qué y.
Qué observar: los peldaños suben en cuatro franjas. Las dos primeras franjas (secciones 1 a 5) observan lo que existe; las dos últimas (6 a 10) proponen y prueban. El énfasis está en el peldaño 10 porque de él sale tu lista de trabajo — pero solo tiene valor si los peldaños inferiores están llenos de fragmentos citados.
Resumen ejecutivo — los 5 problemas más importantes
Te exige decidir si estos 5 son realmente tus problemas. Si ninguno te resulta familiar, el alcance estaba mal definido.
Métricas — instrucciones analizadas, recuento por decisión, % de reducción estimada
Te exige comprobar si el número de instrucciones analizadas coincide con el tamaño real de lo que pediste leer. Un número demasiado bajo significa que la lectura fue parcial.
Problemas por archivo — Archivo | Problema | Severidad | Recomendación | Justificación
Te exige comprobar que la justificación sea un argumento, no un adjetivo. "Verbos" no es una justificación; "duplica la regla X del archivo Y" sí lo es.
Candidatas a eliminar — Fragmento | Archivo | Motivo | Riesgo | Cómo probar
La sección más importante. Exige: abrir el archivo y comprobar el fragmento. Sin la columna "Cómo probar", el informe está incompleto — eliminar sin probar es apostar.
Redundancias y conflictos
Te exige decidir qué copia se queda. Un conflicto sin resolver sigue dejando que el modelo elija por su cuenta, y tú sin saber cuál eligió.
Skills — Skill | Función actual | Diagnóstico | Recomendación | Reducción estimada
Te exige reconocer la función descrita. Si la "función actual" no es para lo que usas la skill, su descripción miente, y el activador también.
CLAUDE.md propuesto — versión mínima completa
Te exige leerlo como un borrador, no como una orden. Viene en un bloque de código y es una propuesta: no se aplicó nada a tu archivo.
Skills propuestas: versiones reducidas de las que se mantienen
Te exige verificar que el procedimiento siga siendo ejecutable después del recorte. Que una skill sea más breve no es una mejora si perdió un paso esencial.
Plan de ablación — A (actual) / B (simplificada) / C (mínima)
Te exige reconocer las 5 a 10 tareas propuestas como tareas reales de tu proyecto. Una tarea hipotética no prueba nada. Y es el tema del Módulo 4.1.
Top 10 cambios — según impacto esperado ÷ riesgo
Te exige revisar tu cola de trabajo. Si aparece aquí un elemento que no está en ninguna sección anterior, surgió de la nada: desconfía.
⚠️ La skill no aplica nada; no le pidas que edite
¿Terminaste de leer el informe y te dieron ganas de decir «ahora aplica el Top 10 por mí»? No lo pidas. Aplicarlo en la misma sesión de la auditoría mezcla diagnóstico con ejecución: pierdes la versión A (la config original intacta) que el plan de ablación necesita como línea de base, y pierdes la oportunidad de discrepar elemento por elemento. Hazlo en otra sesión, con el informe guardado abierto al lado.
🧩 Audita skill por skill
Una instrucción suelta tiene 6 decisiones posibles (KEEP · SIMPLIFY · MOVE · MERGE · TEST · REMOVE). Una skill tiene 7, porque una skill es una unidad con límites: se puede dividir, fusionar o cambiar el momento en la que se carga. Esta última posibilidad — load-on-demand, cargar solo cuando la tarea lo requiere en vez de mantenerla siempre en el contexto, y la que más espacio libera sin perder nada.
| Decisión | Significa | Señal típica |
|---|---|---|
| KEEP | Se queda como está | Resuelve un problema recurrente y no tiene relleno |
| SIMPLIFY | Se queda, pero más breve | Buenos criterios enterrados en demasiados pasos y ejemplos |
| MERGE | Fusionar con otra | Dos skills que compiten por el mismo activador y dicen casi lo mismo |
| SPLIT | Se convierte en dos | Un archivo con dos procedimientos que nunca se usan juntos |
| LOAD-ON-DEMAND | Solo se carga cuando la pides | Útil, pero poco frecuente — no hace falta que consuma contexto en el otro 90% de las tareas |
| CONVERT-TO-CONTEXT | Se convierte en dos líneas en el CLAUDE.md | No hay ningún procedimiento ahí, solo un hecho que debe estar siempre disponible |
| DELETE-CANDIDATE | Candidata a desaparecer | Enseña razonamiento genérico que el modelo ya hace por sí solo |
Las decisiones anteriores no salen de la nada. Se desprenden de siete preguntas que la skill hace para cada archivo y que puedes hacer por tu cuenta, leyendo cualquiera de tus skills:
Las preguntas que deciden
- 1.¿Tiene que existir?
- 2.Qué problema recurrente ¿lo resuelve? (una vez no es recurrente)
- 3.¿Qué parte es contexto, cuál es procedimiento y cuál es microgestión?
- 4.¿Cabría en una instrucción breve?
- 5.¿Debería cargarse solo bajo demanda?
- 6.¿Se puede dividir o fusionar con otra?
- 7.¿Incluyen cosas que el modelo ya hace por su cuenta?
💡 Consejo práctico
La pregunta 3 es la que más rinde. Elige una skill tuya y marca cada párrafo con una de las tres letras: C (contexto: hecho que el modelo no infiere), P (procedimiento: paso realmente repetible) o M (microgestión: tú dirigiendo cómo él piensa). Toda M es candidata inmediata a convertirse en criterio de salida. La skill hace exactamente eso, pero en todo el archivo.
🧪 Ejecuta y revisa 3 eliminaciones
Es hora de ejecutar. Llamada directa por nombre o mediante un disparador en lenguaje natural — la diferencia es que la llamada directa elimina la
lotería: no dependes de que la descripción de la skill coincida con tu frase. Pide el resultado en un archivo .md nuevo; un informe
de 10 secciones en el chat se desplaza fuera de la pantalla antes de que termines de revisarlo.
Cómo llamar
# chamada direta (recomendada) /audit-ablacao # por gatilho, em linguagem natural faz uma auditoria de ablacao do meu CLAUDE.md global audita as skills deste projeto, meu prompt ta inchado o que da pra remover da minha config sem quebrar nada? # pedindo a saida em arquivo (faca isso) /audit-ablacao — escopo: ~/.claude/CLAUDE.md e ~/.claude/skills/. Salve o relatorio completo, com as 10 secoes, num arquivo .md NOVO no diretorio de trabalho. Nao edite nenhum arquivo de config.
✓ Informe que aceptas
- ✓Cada recomendación cita archivo y fragmento
- ✓Cada eliminación relevante viene acompañada de una explicación del riesgo
- ✓La columna «Cómo probar» está completa con una prueba que puedes ejecutar
- ✓Donde falta evidencia, la decisión es TEST, no KEEP ni REMOVE
✗ Informe que devuelves
- ✗Diagnostica basándose en suposiciones sobre un archivo que no leyó
- ✗"Demasiado verboso, recorta" sin señalar el fragmento
- ✗Tratar la eliminación de un guardrail de seguridad como una mejora de concisión
- ✗Reducción del 70 % celebrada sin ningún plan de pruebas
💡 Lo breve no siempre es mejor
La meta no es la mayor reducción porcentual. Es calidad + autonomía + verificabilidad ÷ complejidad. El contexto que el modelo no puede inferir por sí solo —identidad del proyecto, rutas de archivos, fuentes de verdad, branding, seguridad, cumplimiento, contratos de interfaz— no entra en la lista de recortes por ser extenso. Si el informe propone eliminar algo de este grupo, la respuesta correcta es «no», no «qué bien, un 8 % más».
🎯 Ejercicio: audita al auditor
Objetivo: salir de la lectura pasiva. Vas a tomar 3 recomendaciones REMOVE de tu propio informe y comprobarlas una por una, en el archivo, con el fragmento abierto frente a ti.
1. Rode a skill no escopo escolhido, salvando em relatorio-ablacao.md 2. Abra a secao 4 (Candidatas a remocao) e escolha 3 linhas 3. Para cada uma: - abra o arquivo citado no trecho - confirme que o trecho existe MESMO, e no lugar indicado - anote arquivo:linha - de o veredito: CONCORDO / DISCORDO / MUDA PARA TEST - escreva uma frase dizendo por que Formato da anotacao: ~/.claude/CLAUDE.md:42 — MUDA PARA TEST "o risco descrito e real, mas nao existe teste proposto; quero ver o modelo falhar sem isso antes de apagar"
Criterio de salida: un archivo .md guardado
con el informe completo en las 10 secciones, más 3 veredictos escritos, cada uno indicando arquivo:linha. Si no
lograste localizar el fragmento de alguna de las 3, eso ya es un hallazgo: la skill opinó sobre algo que no leyó bien, y esa línea
se convierte en DISCREPO de inmediato.
Revisión rápida (no bloquea nada): el informe incluye una línea en la sección 4 que recomienda REMOVE para un párrafo de tu CLAUDE.md, con el motivo y el riesgo completos, pero la columna «Cómo probar» está vacía. ¿Qué haces?
📌 Resumen del Módulo
~/.claude/skills/, o por proyecto en .claude/skills/; después, reinicia la sesión.Próximo módulo:
3.2 — Del informe a los recortes: convertir el Top 10 en una secuencia de cambios aplicables sin perder la línea de base.