Ayer casi tiro el portátil por la ventana de mi cuarto.
Literal.[automatic_youtube_gallery type="search" search="Claude Code me tenía flipando hasta que entendí sus archivos mágicos" cache="2419200" per_page="1" thumb_excerpt="0" player_description="0"]
Estaba intentando configurar Claude Code para mis proyectos de contenido.
Pero tía, es que nadie te explica nada bien de verdad.
Te dicen que es el futuro y que todo es súper fácil.
Mentira.
Me salían archivos por todos lados y yo no entendía nada.
¿Hooks? ¿Skills? ¿CLAUDE.md?
Parece que hablan en un idioma que no es el nuestro.
Así que me pegué toda la noche probando cada cosita.
He roto el código mil veces para que tú no sufras.
Aquí te cuento la verdad sin palabras raras de profesor pesado.
Hooks vs Skills: Lo que Claude hace cuando no miras
Primero vamos con lo que hace que Claude se mueva.
Los Hooks son como ese mensaje de «avísame cuando llegues».
Son automáticos.
Tú no le dices a Claude que los use en ese momento.
Él ya sabe que tiene que hacerlo porque lo configuraste antes.
Es como un portero de discoteca que revisa todo.
Si quieres que formatee el código antes de guardarlo, usas un Hook.
Si quieres que te avise de un error, usas un Hook.
No tienes que pedírselo cada vez que hablas con él.
Simplemente sucede y ya está.
En cambio, las Skills son como superpoderes que le compras.
Bueno, no los compras, los programas o los instalas.
Imagínate que Claude no sabe cocinar, pero le das una Skill.
Ahora sabe hacerte una tortilla de patatas perfecta.
Una Skill es una herramienta nueva que Claude aprende a usar.
Puede ser un script de Python que limpia tus datos feos.
O una conexión con una API que te dice el clima.
Si Claude no puede hacer algo de fábrica, métele una Skill.
Creo que la mayoría de la gente se lía con esto.
Pero piénsalo así: Hook es un hábito, Skill es un talento.
Los archivos Markdown que te están volviendo el cerebro loco
Ahora viene el drama de los archivos .md que ves.
Seguro que has visto el CLAUDE.md en todos los tutoriales aburridos.
Ese archivo es básicamente la biblia de tu proyecto para él.
Es el post-it gigante pegado en la frente de Claude.
Ahí le dices cómo quieres que escriba el código hoy.
«Usa solo librerías modernas» o «no me hables como un robot».
Claude lee este archivo al empezar a trabajar contigo.
Si no lo pones, Claude irá un poco a su bola.
Y créeme, cuando va a su bola la suele liar parda.
Es como darle las reglas de tu casa a un invitado.
«En esta casa nos quitamos los zapatos al entrar».
Eso es CLAUDE.md para tu repositorio de código.
Luego está el SKILL.md que es algo mucho más específico.
Si creas una Skill, necesitas explicarle a Claude cómo usarla.
No basta con darle el código del script y ya.
En el SKILL.md le pones el manual de instrucciones del juguete.
«Mira Claude, para usar esta Skill tienes que pasarle este dato».
Es un archivo que solo sirve para que esa habilidad funcione.
Si no hay Skill, no hace falta que haya SKILL.md.
No lo metas por rellenar porque entonces Claude se queda delirando.
Me pasó a mí y estuve una hora buscando el error.
Agents.md y el casting de tu propia película
Este es mi favorito porque me hace sentir como una jefa.
El archivo agents.md sirve para crear mini-Claudes especializados.
Imagínate que tienes un proyecto gigante de redes sociales.
Necesitas a alguien que sea experto en bases de datos.
Y a otra persona que sea una crack del diseño visual.
En agents.md defines a esos «personajes» o sub-agentes.
Le dices: «Tú vas a ser el Agente de Estilo».
Le das sus propias reglas y su propia personalidad de trabajo.
Cuando Claude Code necesita ayuda con el diseño, llama a ese agente.
Es como tener un equipo de becarios gratis dentro de tu terminal.
Si estás haciendo algo simple, quizás no lo necesites todavía.
Pero cuando el proyecto crece, agents.md te salva la vida entera.
Yo al principio pensaba que era una tontería para flipados.
Pero qué va, te organiza el trabajo que da gusto verlo.
Parece que Claude se multiplica y cada uno sabe lo suyo.
Es mil veces mejor que tener a un solo Claude haciendo todo.
Porque cuando uno hace todo, al final no hace nada bien.
Plugins: El pack completo que te ahorra tiempo
Los Plugins son para las que somos un poco vagas.
Bueno, vagas no, eficientes, que suena mucho mejor.
Un Plugin es como un combo del McDonald’s de Claude.
En lugar de crear una Skill por aquí y un Hook por allá…
Alguien ya ha juntado todo lo necesario en un solo paquete.
Lo instalas y de repente Claude ya sabe hacer mil cosas nuevas.
Suele venir con sus propias Skills y sus configuraciones listas.
Es ideal si no quieres estar horas picando código base.
Yo los uso cuando quiero probar una tecnología que no conozco.
Busco si hay un Plugin de Claude para eso y lo instalo.
Te quitas de encima toda la configuración aburrida del principio.
Es como comprar el mueble de IKEA ya montado por otro.
Obvio que mola más saber hacerlo tú desde cero algún día.
Pero para empezar a crear contenido rápido, los Plugins mandan.
¿Cuándo narices tengo que usar cada cosa?
Te voy a dar el resumen que yo quería encontrar ayer.
Si quieres que algo pase solo siempre, haz un Hook.
Si quieres que Claude aprenda a usar una herramienta, crea una Skill.
Si quieres darle las normas de tu proyecto, usa CLAUDE.md.
Si tienes que explicarle cómo funciona esa Skill, haz un SKILL.md.
Si quieres un equipo de expertos diferentes, crea un agents.md.
Y si no quieres trabajar mucho, búscate un Plugin hecho.
Es así de sencillo y no como te lo cuentan los expertos.
Ellos quieren que parezca difícil para sentirse más listos que nosotras.
Pero tú y yo sabemos que solo es cuestión de orden.
Ayer mismo estaba intentando que Claude me editara unos vídeos.
Y el pobre no sabía ni por dónde empezar el proceso.
Le metí un CLAUDE.md explicándole mi estilo de edición.
Luego le puse una Skill para que pudiera leer archivos mp4.
Y de repente, pum, el tío empezó a trabajar como un loco.
Me ahorró tres horas de trabajo manual súper pesado.
Pude irme a tomar un café con mis amigas mientras él curraba.
Eso es lo que mola de entender estas herramientas de verdad.
No es por el código, es por el tiempo que te regalan.
Errores que yo cometí para que tú no los hagas
No intentes llenar todos los archivos el primer día de uso.
Yo empecé poniendo de todo en el agents.md y fue un caos.
Claude se confundía de agente y me contestaba cosas rarísimas.
Empieza solo con el CLAUDE.md, que es el más importante.
Ve paso a paso y solo añade cosas cuando veas que falta algo.
No seas una intensa de la organización desde el minuto uno.
Otro error típico es poner instrucciones contradictorias entre archivos.
Si en CLAUDE.md dices que odias el color azul…
Pero en tu Skill de diseño pones que todo sea azul…
Claude va a entrar en cortocircuito y te va a dar errores.
Sé coherente con lo que le pides a tu bot de confianza.
Al final, Claude es como ese amigo que sabe muchísimo.
Pero si le das las instrucciones mal, te trae un té con sal.
Espero que con esto ya no sientas que te explota la cabeza.
La próxima vez que leas sobre esto, ya sabrás de qué va el rollo.
No dejes que los términos raros te asusten de tu camino.
Mitologia Colosal está aquí para que aprendas a usar esto.
Me parece que el futuro es de las que dominamos estas IA.
Y ahora tú ya tienes ventaja sobre todos esos tíos intensos.
Disfruta de tu nuevo tiempo libre mientras Claude hace el trabajo.
Nos vemos en el próximo post, que seguro que será igual de útil.
Preguntas que me hicisteis por privado sobre esto
¿Claude lee el CLAUDE.md cada vez que escribo algo?
Sí, lo tiene presente durante toda la sesión de chat activa.
Es como su memoria a corto plazo que no se borra nunca.
¿Puedo tener varios archivos agents.md en el mismo sitio?
Normalmente tienes uno donde defines a todos tus agentes listos.
No los separes o Claude no sabrá a quién llamar para ayudar.
¿Las Skills tienen que estar escritas en algún lenguaje especial?
Suelen ser scripts que tu ordenador pueda ejecutar sin problemas.
Python o JavaScript son los que mejor funcionan con Claude Code.
¿Qué pasa si borro el CLAUDE.md de repente?
Claude perderá el contexto de cómo te gusta trabajar a ti.
Seguirá siendo listo, pero ya no será «tu» Claude personalizado.
Será un desconocido otra vez y tendrás que explicarle todo.
¿Los Hooks ralentizan mucho el trabajo de Claude?
Si pones mil Hooks pesados, pues un poco sí que tardará.
Pero para cosas normales de formato ni te vas a enterar.
Vale la pena perder un segundo y que todo salga perfecto.