Una skill que revisa tu tabla antes de contar
Escribe la skill revisa-tabla, úsala con /revisa-tabla y comprueba que Claude Code la carga sola cuando le pides contar algo.
Curso gratis. Tu Maestro, una IA, .
En el Módulo 2 revisaste planetas.csv paso por paso antes de dar por bueno un conteo: cuántas filas trae, qué representa cada fila, si un mismo planeta se repite y si faltan datos. En lugar de escribir esas preguntas cada vez que llega un archivo nuevo, puedes guardarlas en una Palabra del glosario para que Claude Code haga esa revisión siempre en el mismo orden.
Crea la carpeta y el archivo SKILL.md
Dentro de tu carpeta exoplanetas, crea la carpeta .claude, adentro skills y adentro revisa-tabla. En esa Palabra del glosario guarda un archivo llamado exactamente SKILL.md con las instrucciones de abajo.
Si prefieres no crear las carpetas a mano desde el explorador de archivos, pídele a Claude Code en tu sesión actual que cree .claude/skills/revisa-tabla/SKILL.md con este contenido. Así evitas que Windows o Mac le agreguen una terminación .txt oculta al final del nombre.
---name: revisa-tabladescription: Revisa una tabla de datos (CSV o Excel) antes de contar o promediar nada con ella. Úsala cuando te pida analizar, resumir o contar algo de una tabla nueva.---Antes de calcular cualquier número con la tabla que te indiquen ($ARGUMENTS):1. Dime cuántas filas y cuántas columnas tiene.2. Dime qué representa una fila. Si una misma cosa (una persona, un planeta, un ticket) aparece en varias filas, dilo y dime qué columna lo distingue.3. Dime qué columnas tienen celdas vacías y cuántas.4. Muéstrame cinco filas repartidas: dos del principio, una de en medio y dos del final.5. No cambies el archivo original.Termina con una frase: "Para contar X en esta tabla, cuenta Y", donde Y dice qué filas o qué columna usar.Aunque ocupa pocas líneas, este archivo tiene la estructura completa de una especificación de tarea para un agente y cubre el perfilado básico de cualquier tabla:
Objetivo y disparador en description
El encabezado entre líneas
---le dice a Claude Code cómo se llama la skill y cuándo conviene cargarla: antes de contar, resumir o promediar datos de una tabla nueva.Insumo y preguntas de perfilado
La variable
$ARGUMENTSrecibe el nombre del archivo. Los pasos 1 a 4 perfilan la calidad de la tabla: su tamaño, qué representa cada fila, qué columna identifica registros únicos, cuántas celdas vacías hay y cinco filas reales repartidas por todo el archivo.Restricción explícita
El paso 5 fija el límite de seguridad de la tarea: inspeccionar y leer los datos sin modificar el archivo original.
Criterio de cierre verificable
La instrucción final exige cerrar con la oración
"Para contar X en esta tabla, cuenta Y". Así sabes de un vistazo si terminó el análisis y qué regla aplicará.
Fíjate en los pasos 2 y 4 del archivo. El paso 2 obliga a revisar la Palabra del glosario antes de sumar o contar filas, y el paso 4 pide una Palabra del glosario con filas del inicio, de la mitad (en planetas.csv, alrededor de la línea 20177) y del final (líneas 40350 y 40351), para no quedarte solo con las primeras líneas del archivo.
Error común: Dos descuidos que impiden que Claude Code encuentre tu skill
El archivo debe llamarse SKILL.md en mayúsculas y vivir dentro de .claude/skills/revisa-tabla/. Si lo guardas directo en .claude/skills/ o con el nombre revisa-tabla.md, Claude Code lo ignora. Revisa también que la primera línea del archivo sea exactamente ---, sin renglones en blanco arriba, y que otro --- cierre el encabezado después de description.
Úsala por su nombre
Para probarla de forma directa, abre una sesión nueva en tu carpeta exoplanetas y escribe el comando seguido del nombre de la tabla:
/revisa-tabla planetas.csvEn la sesión de prueba del 31 de octubre de 2026 con Claude Code 2.1.314, el agente leyó planetas.csv con Python, inspeccionó las líneas 2, 3, 20177, 40350 y 40351 del archivo, confirmó que no modificó el original y respondió punto por punto:
**1. Tamaño:** 40,350 filas de datos (sin contar el encabezado) y 5 columnas: `pl_name`, `hostname`, `disc_year`, `discoverymethod`, `default_flag`.**2. Qué representa una fila:** una fila no es un planeta. Es una fila por cada publicación o medición de un planeta. Solo hay 6,451 planetas distintos (`pl_name`), así que un mismo planeta aparece en varias filas. TrES-2 b aparece 34 veces y Kepler-10 b 25. Solo 937 planetas aparecen una vez.La columna que distingue la versión "oficial" es `default_flag`. Vale 1 en exactamente una fila por planeta (6,451 filas) y 0 en las otras 33,899. Lo comprobé: ningún planeta tiene dos filas con 1 ni se queda sin ninguna.**3. Celdas vacías:** ninguna columna tiene celdas vacías (0 en las cinco). Todas las filas tienen 5 campos.[...]Para contar planetas en esta tabla, cuenta las filas con `default_flag` = 1 (o los valores distintos de `pl_name`). Cuenta filas sin filtrar solo si quieres contar mediciones publicadas, no planetas.Todo lo que averiguaste en varios turnos durante el Módulo 2 aparece aquí en una sola respuesta y termina con la regla de conteo que pediste.
Comprueba que la carga sola cuando pides contar
La ventaja de escribir una buena description es que no necesitas acordarte de teclear /revisa-tabla cada vez. En una segunda prueba del mismo 31 de octubre de 2026, abrimos otra sesión nueva (con CLAUDE.md presente en la carpeta) y preguntamos únicamente:
"¿Cuántos planetas se descubrieron en 2025 y en 2026, y cuál año tuvo más?"
Sin que nadie nombrara la skill, Claude Code detectó que la pregunta pedía contar datos de una tabla, cargó revisa-tabla por su cuenta, ejecutó primero la revisión y después contestó la pregunta: 246 planetas en 2025 y 361 en 2026.
En esa segunda corrida ocurrió un detalle importante: al imprimir las cinco filas de muestra, la salida de su comando se cortó, y Claude Code lo avisó en su respuesta con las palabras "Mi comando solo imprimió una vista recortada, así que la muestra es incompleta." Una skill obliga al agente a seguir tu lista de verificación y a reportar dónde se quedó corto, pero leer esa advertencia y decidir si le pides las filas faltantes sigue estando de tu lado.
Adapta los pasos a tus propias tablas
El archivo SKILL.md de esta página sirve como punto de partida, pero tus tablas del trabajo tienen detalles que el catálogo de la NASA no tiene: fechas mezcladas en formatos distintos, facturas con estatus cancelado que siguen en la base, columnas de importe con y sin impuestos o sucursales que entregan su corte un día después. Cuando lleves esta skill a una carpeta de tu trabajo, cambia o agrega pasos para que revise lo que a ti te ha hecho repetir cuentas. Si quieres redactar un paso específico para las tablas que usas a diario, cuéntale a tu Maestro qué problema suele aparecer en tus archivos.
Inténtalo
Haz las dos pruebas en tu computadora:
- Guarda
.claude/skills/revisa-tabla/SKILL.mden tu carpetaexoplanetas, abre una sesión nueva y corre/revisa-tabla planetas.csv. - Abre otra sesión nueva y haz una pregunta de conteo sin nombrar la skill, por ejemplo:
"¿Cuántos planetas se descubrieron en 2025 y en 2026, y cuál año tuvo más?".
Cómo comprobar que funcionó: En la primera prueba, verifica que la respuesta incluya las 40,350 filas y 5 columnas, los 6,451 planetas distintos, que TrES-2 b sale 34 veces, que hay 0 celdas vacías, las cinco filas de muestra y la frase final con default_flag = 1 o pl_name. En la segunda prueba, revisa que Claude Code indique al inicio que cargó revisa-tabla antes de darte los totales de 246 y 361. Si Claude Code dice que no reconoce el comando o contesta directo sin cargar la skill, dile a tu Maestro qué ruta usaste y qué te apareció.