«Me preocupa no poder usar IA porque no tengo conocimientos de programación…»
«Me da miedo mirar la pantalla negra del terminal y no me apetece hacerlo.»
«Pero me angustia quedarme atrás en la tendencia de la IA 😱»
Incluso en ese estado, al permitir que Claude Code aprenda mis «propios patrones de acción», una tarea que antes tomaba 30 minutos cada vez ahora toma 5.
De hecho, la oportunidad está llegando precisamente para los no ingenieros.
La clave son las Skills.
En términos de Pokémon, es una «Máquina Técnica» (MT).
Al usar Claude Code, ¿alguna vez te has sentido así?
- Ciertamente es inteligente. Pero cada vez tengo que configurar el formato, los criterios de juicio y la información de contexto yo mismo.
- Aunque sea IA, hay mucho trabajo manual. «¿No es esto lo mismo que hacerlo todo yo mismo?»
- ¿Otras personas lo están usando de manera más efectiva?
- Lo estoy usando, pero no lo domino. No sé cuál es la diferencia.
Cuando termines de leer este artículo, podrás crear un entorno donde solo configures tu flujo de trabajo en la IA una vez, y cada vez obtengas resultados de la misma calidad.
Santiago (@santtiagom_), un ingeniero en MercadoLibre, la empresa de comercio electrónico más grande de Sudamérica, publicó una guía completa sobre Skills en español que actualmente se está volviendo viral con más de 580,000 visitas.
Él dice que creó más de 50 Skills él mismo y eliminó la mayoría en dos días. Esta guía se basa en su experiencia de la vida real de lo que quedó y cambió completamente su forma de trabajar con Claude.
Tengo dos peticiones antes de empezar.
- Guarda este artículo y aparta 20 minutos esta semana.
- Si conoces a alguien que use Claude Code, compártelo con él.
Esta vez, explicaré el contenido de una manera fácil de entender.
Aquí está la publicación original.
https://x.com/santtiagom_/status/2030305647535751338
Por qué Claude necesita configuración cada vez
Primero, hablemos de la premisa principal.
Claude Code es muy inteligente. Sin embargo, no conoce «tu forma de trabajar».
Esto no es un problema de rendimiento, sino de cómo funciona.
Claude comienza desde cero cada vez que abres una nueva sesión. A menos que se lo digas cada vez, Claude no sabe qué formato prefieres, qué tipo de informe quiere tu jefe o qué tono usas en los correos electrónicos a los clientes. Estos son «tus criterios de juicio únicos».
Este mecanismo causa tres problemas.
Problema 1: Falta de consistencia
Incluso con la misma solicitud de «crear un informe semanal», hoy podría ser una versión detallada de 2000 caracteres, y mañana podrían ser tres viñetas. Como tu formato deseado no está establecido, Claude tiene que decidir por su cuenta cada vez.
Problema 2: Faltan tus criterios de juicio únicos
Claude es excelente en general. Pero no conoce reglas que solo se aplican en tu entorno, como «en tu empresa, debes empezar con la conclusión» o «tu jefe no lee documentos de más de 3 páginas».
Por lo tanto, cada vez, necesitas configurar ese contexto desde cero.
Problema 3: El esfuerzo de la configuración se acumula
Escribir especificaciones de formato, explicar criterios de juicio y compartir información de contexto.
¿Cuánto tiempo pasas en esta «configuración» en un día? Aunque estés usando IA, te cansas solo con la preparación.
santtiagom_ escribe:
«¿Qué tal si pudieras escribir una instrucción una vez y que se hiciera perfectamente a partir de entonces sin dar instrucciones de nuevo? De eso se tratan las Skills.»
Skills es un mecanismo donde escribes tu flujo de trabajo en un solo archivo y lo configuras en Claude. Una vez configurado, Claude actuará de acuerdo a él la próxima vez sin que digas nada.
A partir de aquí, explicaré la imagen general de las Skills en orden.
Las Skills son las «Máquinas Técnicas» de Claude
¿Alguna vez has usado una «Máquina Técnica» (MT) en Pokémon?
Con solo cargar un disco, ese Pokémon aprende un nuevo movimiento. Una vez aprendido, el movimiento se puede usar tantas veces como quieras en cada batalla. Para siempre, a menos que lo hagas olvidar.
Las Skills son exactamente como estas «Máquinas Técnicas».
Crear un archivo llamado SKILL.md y lo configuras en Claude.
Entonces, Claude actuará según esas instrucciones cada vez que abra una sesión. Ya no necesitarás configurar las cosas cada vez.
Para organizar la correspondencia de manera simple:
- Una MT → Un archivo SKILL.md
- Un Pokémon que aprendió un movimiento lo usa en cada batalla → Claude con una Skill configurada la aplica en cada sesión
- Reemplazable (puede reaprender) → Las Skills también se pueden agregar/eliminar/reemplazar libremente
- Existe compatibilidad (algunos movimientos no se pueden aprender) → Algunas Skills no encajan en el proyecto
Lo importante es que tu trabajo también tiene «tareas que se pueden convertir en MTs».
Por ejemplo, al hacer un informe:
«Escribe la conclusión primero. No uses más de 3 puntos de datos. Usa un formato que el jefe pueda juzgar en 5 segundos.»
Si configuras esto como una Skill, Claude seguirá automáticamente esta regla la próxima vez.
Al hacer un informe semanal:
«Tres partes: Resultados de la semana pasada → Planes de esta semana → Problemas.
Escribe los números como una comparación semana contra semana.» También puedes configurar esto como una Skill.
Al escribir un correo electrónico a un cliente:
«Expresa gratitud al principio. Mantén el punto principal dentro de 3 líneas. Indica claramente solo una siguiente acción.» Esto también.
Comparemos un mundo con Skills y un mundo sin ellas.
[Sin Skills]
Pides «crear un informe semanal» → Claude genera en su propio formato → Lo corriges: «No, la conclusión primero», «Limita los datos a 3 puntos» → La semana siguiente, empiezas desde cero escribiendo todo de nuevo.
[Con Skills]
Pides «crear un informe semanal» → Claude genera según las Skills → Desde el principio, está en el formato «Conclusión → 3 Puntos de Datos → Problemas» → Las correcciones son casi nulas.
santtiagom_ enfatiza repetidamente esta forma de pensar en su artículo:
«Una Skill funcional de 5 líneas es más valiosa que una Skill perfecta con 80 reglas.»
No necesitas crear instrucciones perfectas. Incluso solo dos líneas como «Escribe desde la conclusión. Hasta 3 puntos de datos» serán efectivas si se configuran como una Skill.
Y esta es la parte que personalmente más quiero transmitir.
La esencia de las Skills no es la «automatización del trabajo».
Es el «acto de verbalizar tus criterios de juicio y configurarlos en la IA».
«Escribe desde la conclusión», «Limita los datos a 3 puntos». Estos no son procedimientos de trabajo, sino tus criterios de juicio. Qué información priorizar, en qué orden transmitirla y con qué nivel de detalle escribir.
Dejas esos juicios en un archivo. Así como un movimiento aprendido de una MT se convierte en la fuerza de un Pokémon, los criterios de juicio verbalizados se convierten en la fuerza de Claude.
La capitalización del juicio. Si tuviera que describir las Skills en una palabra, esto es.
Todo lo que Necesitas es un Archivo: SKILL.md
El mecanismo de las Skills es mucho más simple de lo que piensas.
Todo lo que necesitas es un archivo llamado SKILL.md.
El contenido de este archivo se divide en dos partes.
Parte 1: La «Portada» con Nombre y Descripción
En la parte superior del archivo, escribes el nombre de la Skill y una descripción de «cuándo debe usarse».
Claude mira esta «portada» y juzga «si debe usar esta Skill para la tarea actual». Si esto es ambiguo, Claude no encontrará la Skill que te costó crear.
Por ejemplo, con solo el nombre «Creación de Informes», Claude se preguntará «¿Qué informe? ¿Cuándo lo uso?»
Si escribes «Crear un informe de ventas semanal para el Gerente Tanaka. Estructura: Conclusión → Números → Problemas», Claude seleccionará automáticamente esta Skill en el momento en que llegue una solicitud de informe semanal.
En términos de MT, esta portada corresponde al juicio de «qué Pokémon puede aprender este movimiento».
Parte 2: El «Cuerpo» con Instrucciones Específicas
Esta es tu forma real de trabajar.
Escribes procedimientos y reglas específicos como «Escribe en este orden», «Sigue este formato» y «Asegúrate de verificar solo este punto».
Las Skills funcionan solo con estas dos partes.
Es más rápido mirar un archivo real, así que aquí hay un ejemplo. Asume una situación donde un equipo de ventas envía un informe semanal a su jefe cada semana.
1---2name: Informe de Ventas Semanal3description: Usar al crear el informe semanal para el equipo de ventas cada lunes. Para el Gerente Tanaka.4---56# Informe de Ventas Semanal78## Formato9- Escribe la conclusión (llegada esperada para esta semana) en la primera página10- Incluye siempre números como una comparación semana contra semana (ej., +12% vs la semana pasada)11- Clasifica los negocios en tres niveles: A/B/C12- Limita los problemas a uno, y añade una línea de acción específica para la próxima semana1314## Reglas del Gerente Tanaka15- No lee más de 3 páginas. Mantenlo dentro de 2 páginas16- Prefiere tablas sobre gráficos17- No escribas «en consideración». Conviértelo siempre en «qué se hará y para cuándo»
Esta es la imagen general de SKILL.md.
Mirando la descripción en la «portada» que dice «cada lunes… para el Gerente Tanaka», Claude juzga automáticamente: «Oh, esto es sobre el informe semanal».
Luego, siguiendo las instrucciones en el «cuerpo», crea un informe de 2 páginas o menos comenzando con la conclusión en el mismo formato cada vez.
Reglas como «Reglas del Gerente Tanaka», que solo se aplican en tu lugar de trabajo, son el verdadero valor de las Skills. No importa lo inteligente que sea Claude, no sabrá las preferencias del Gerente Tanaka a menos que se las enseñes.
Hay dos formas de activarlo.
La primera es llamarlo directamente tú mismo, como «/crear-informe». Úsalo cuando quieras asegurarte de que se active.
La segunda es que Claude lea la descripción de la portada y juzgue automáticamente que «esto debería usarse ahora». Si la descripción está bien escrita, se activará por sí solo sin que des ninguna instrucción.
Si se convierte en una Skill más grande, puedes añadir carpetas auxiliares para materiales de referencia y plantillas, pero un solo SKILL.md es suficiente al principio.
Claude no se Ralentizará Incluso con 50 Skills
«Si pongo muchas Skills, ¿no se ralentizará el movimiento de Claude?»
Creo que esta es una pregunta que todos tienen al principio.
La respuesta es: no se ralentizará.
Claude no carga todas las Skills a la vez; está diseñado para cargar solo lo necesario por etapas.
En términos de MT, un Pokémon no está pensando en todos sus movimientos todo el tiempo. Elige el movimiento a usar según la situación de la batalla. Claude es igual.
Nivel 1: Primero, echa un vistazo a los nombres
Primero verifica ligeramente solo el «nombre y la descripción» de todas las Skills. Aún no ha leído el contenido del archivo.
Nivel 2: Lee el texto completo solo de lo necesario
Si encuentra una Skill que parece relacionada con la solicitud actual, lee el texto completo de solo esa Skill. No toca el resto.
Nivel 3: Lee materiales relacionados adicionales si es necesario
Si la Skill especifica «por favor, lee también este material de referencia», lee ese archivo también.
En otras palabras, incluso si hay 50 Skills, solo las «1 o 2 relacionadas con el trabajo actual» se cargan realmente. No tiene casi ningún impacto en el rendimiento.
Sin embargo, hay una cosa a tener en cuenta.
Si la «descripción» en la portada es descuidada, Claude no podrá encontrar la Skill necesaria.
En el Nivel 1, podría ser malinterpretada como «esto no parece relacionado esta vez» y omitirse.
Por eso dije que la descripción de la portada es lo más importante. Es vital escribir claramente «cuándo y para qué tipo de tarea debe usarse esta Skill».
Como guía práctica, no hay ningún problema siempre que el total de todos los nombres y descripciones de las Skills esté dentro de los 15,000 caracteres. Es poco probable que alcances este límite con un uso normal.
Tu Primera Skill se Completa en 6 Pasos
Ahora, la parte práctica.
Desglosaré los «6 pasos para crear tu primera Skill» introducidos por santtiagom_.
Sin embargo, primero identifica el momento para crear una Skill. Si se aplica incluso una de las siguientes tres condiciones, es hora de una Skill:
- Hay información de contexto que estás escribiendo manualmente (formato, reglas, tono, etc.)
- Hay una tarea que deseas que se produzca con la misma calidad cada vez
- Hay un paso que siempre olvidas
Por el contrario, las Skills no son adecuadas para tareas únicas o trabajos donde las condiciones son completamente diferentes cada vez.
Veamos los 6 pasos en orden.
1️⃣ Las semillas de las Skills están en la repetición
«Si has escrito la misma información de contexto 3 o más veces, es candidata para una Skill.»
santtiagom_ afirma esto.
Formatos de actas de reuniones, reglas de estructura de informes, tonos de correo electrónico. Si hay información de contexto que escribes cada vez, esa es una señal de que debe configurarse en una Skill.
A partir de hoy durante una semana, intenta tomar notas sobre lo que escribes manualmente en Claude. Encontrarás cosas que repites 3 o más veces.
2️⃣ Prepárate con una carpeta y un archivo
Crea una carpeta llamada .claude/skills/ dentro de tu proyecto de Claude Code, crea una carpeta con el nombre de la Skill dentro y coloca el archivo SKILL.md allí.
1.claude/skills/2 └── informe-semanal/3 └── SKILL.md
Eso es todo lo que necesitas para estar listo.
3️⃣ 5 líneas son suficientes al principio
Recuerda las palabras de santtiagom_: «Una Skill funcional de 5 líneas es más valiosa que una Skill perfecta con 80 reglas.»
No aspires a la perfección desde el principio.
Incluso para el ejemplo del informe semanal anterior, esto es suficiente al principio:
1---2name: Informe de Ventas Semanal3description: Usar al crear el informe semanal para el equipo de ventas cada lunes4---56Escribe la conclusión primero. Los números son comparación semana contra semana. Limita los problemas a uno. Dentro de 2 páginas.
Hecho. El cuerpo es solo una línea.
¿Qué te parece? Si es solo esto, ¿podrías hacerlo desde hoy, verdad?
A medida que lo uses, si notas que «al Gerente Tanaka le gustan más las tablas que los gráficos» o «Si escribo 'en consideración', me lo devuelven», solo tienes que añadirlos cada vez.
La versión terminada de antes es el resultado de haberlo hecho crecer así.
4️⃣ El efecto es claro con pruebas de comparación
Prueba la misma solicitud tanto con la Skill activada como con ella desactivada.
Si hay una diferencia clara en el resultado, es una prueba de que la Skill está funcionando.
Si no hay diferencia, el contenido de la Skill podría contener solo cosas que «Claude ya sabe». Intenta añadir criterios de juicio que solo tú conocerías.
5️⃣ Las Skills crecen cada vez que fallan
Si sientes que «esta parte aún está mal» después de la prueba, añade eso a SKILL.md cada vez.
Para tomar prestadas las palabras de santtiagom_, «Si has hecho la misma corrección 3 veces, añádela a la Skill.»
Una Skill perfecta no es algo que se haga desde el principio; es algo que se hace crecer a medida que se usa. Este proceso de «aprender del fracaso y crecer» es el acto de hacer tus criterios de juicio cada vez más precisos.
6️⃣ El propio Claude dará sugerencias de mejora
Esta es la parte interesante.
Usando la Skill skill-creator proporcionada oficialmente por Anthropic, el propio Claude sugerirá cosas como «¿Qué tal si haces esto para mejorar aún más esta Skill?»
Una vez que configuras tu flujo de trabajo en la IA, la IA luego responde con «Sería más eficiente hacerlo de esta manera». Este ciclo es la diversión y la fuerza de las Skills.
3 Señales de Alerta para Hacer Crecer Skills Útiles
Una vez que hayas creado una Skill, necesitas verificar si está funcionando correctamente.
santtiagom_ enumera solo un método de juicio.
Si ejecutas la misma tarea 3 veces y obtienes resultados diferentes cada vez, esa Skill necesita mejora.
Específicamente, presta atención a estas tres señales de alerta:
Señal de Alerta 1: Las instrucciones son ignoradas
Esto sucede cuando la redacción de la Skill es ambigua.
Por ejemplo, incluso si especificas «escribe claramente», los criterios para «claro» no son claros para Claude. En este caso, Claude no tiene más remedio que escribir basándose en su propio juicio.
«Escribe la conclusión primero. Mantén una oración dentro de 40 caracteres. No uses términos técnicos.»
Si escribes de manera específica hasta este punto, Claude no dudará. El truco es escribir con números y reglas específicas en lugar de adjetivos ambiguos.
Señal de Alerta 2: La Skill no se activa
Este es un caso donde hay un problema con la descripción de la «portada».
Recuerda la charla sobre la carga por etapas de antes. Claude juzga mirando solo el «nombre y la descripción» en el Nivel 1. Si la descripción aquí es ambigua, se omitirá como «no parece relacionado esta vez».
Verifica si la descripción deja claro de un vistazo «cuándo y para qué tarea debe usarse».
Señal de Alerta 3: El resultado es genérico, sin diferencia con/sin Skill
Este es un estado donde el contenido escrito en la Skill son solo cosas que «Claude ya sabe».
Claude es inteligente, por lo que puede juzgar cosas generales por su cuenta sin que se le enseñen. La forma correcta es escribir criterios de juicio que solo tú conoces en las Skills.
«El jefe lee desde la conclusión», «Omite los datos si exceden los 3 puntos», «Se enfada si no está escrito como una comparación semana contra semana». Estas reglas, necesarias precisamente por tu entorno, determinan el valor de una Skill.
De las mejores prácticas de santtiagom_, he seleccionado 4 puntos particularmente importantes para presentar.
① Claude es inteligente. No es necesario enseñarle lo que ya sabe.
Instrucciones generales como «genera en formato JSON» son innecesarias. Claude ya lo sabe. Por favor, enséñale los criterios de juicio de tu trabajo, como «por qué lo haces de esa manera» y «en qué orden lo haces».
② Divídelo si supera las 500 líneas
Él dice 500 líneas, pero en la operación real, alrededor de 100 líneas para el propio skill.md está bien. Si el volumen aumenta demasiado, la calidad del juicio de Claude Code disminuirá.
Por lo tanto, si una Skill se vuelve demasiado grande, almacena los materiales de referencia en una carpeta separada. El truco para un uso a largo plazo es mantener el cuerpo de SKILL.md centrado solo en las instrucciones principales.
③ Prueba con casos reales, no con ideales
Probar con una solicitud ficticia no tiene sentido. Pruébalo con un trabajo que realmente hagas los lunes usando Skills. Es en el trabajo real donde verás las instrucciones que faltan.
④ Hazlo crecer a medida que lo usas en lugar de aspirar a la perfección
Si haces la misma corrección 3 veces, añádela a SKILL.md. Esta repetición es la ruta más corta para hacer crecer una Skill dedicada a ti.
Para Aquellos que Quieren Usarlo Más a Fondo
Esta es la sección avanzada.
No todos necesitan hacer esto de inmediato, pero lo presentaré para aquellos que quieran «aprovecharlo aún más».
1️⃣ Hay Skills oficiales que puedes usar de inmediato
Anthropic, el desarrollador de Claude, ha lanzado oficialmente 5 tipos de Skills.
Procesamiento de archivos de Word, análisis de archivos de Excel, lectura de PDF, generación de PowerPoint y diseño front-end. Puedes usarlos de inmediato solo con instalarlos desde GitHub.
También hay un sitio llamado skills.sh que recopila Skills hechas por la comunidad. Sin embargo, como están hechas por terceros, recomiendo verificar los contenidos antes de usarlas. Existe la posibilidad de que se incluyan cosas arriesgadas, así que presta mucha atención allí.
2️⃣ Hay dos ubicaciones de almacenamiento: para ti y para el equipo
Las Skills tienen dos ubicaciones de almacenamiento.
Solo para ti:
Si lo colocas en .claude/skills/ en tu carpeta de inicio, se convierte en una Skill dedicada a ti que se puede usar independientemente de qué proyecto abras.
Para compartir en equipo:
Si lo colocas en .claude/skills/ dentro de un proyecto, se incluye en el control de versiones, por lo que todo el equipo puede usar la misma Skill.
Personalmente, creo que compartir en equipo es la esencia oculta de las Skills.
El hecho de que tus criterios de juicio se conviertan en un archivo significa que, incluso si alguien del equipo cambia, la calidad del trabajo se mantiene. Los criterios de juicio ya no dependen de individuos. Este es un cambio bastante grande para una organización.
3️⃣ Las Skills también se conectan con servicios externos
Al combinar Skills con MCP, un mecanismo para conectarse a herramientas externas, Claude se vuelve capaz de interactuar directamente con servicios externos.
santtiagom_ describe esto como «volverse capaz de delegar procesos en lugar de instrucciones».
Sin embargo, esto es un uso avanzado para ingenieros. Recomiendo empezar con los 6 pasos básicos presentados en la sección anterior.
Resumen
Resumiré los puntos de este artículo en 6 elementos. Por favor, guárdalo para poder consultarlo.
- Las Skills son «archivos para configurar flujos de trabajo en la IA». Como una MT de Pokémon, una vez configurada, se activa cada vez.
- Claude es inteligente pero no conoce «tu forma de trabajar». Sin Skills, tienes que configurar todo tú mismo cada vez.
- Todo lo que necesitas es un archivo: SKILL.md. El contenido es solo «Nombre + Descripción + Instrucciones».
- Está bien poner 50. Claude selecciona y carga solo las Skills necesarias.
- Empezar pequeño y hacerlo crecer es la forma correcta. Una Skill funcional de 5 líneas supera a una Skill perfecta con 80 reglas.
- La esencia de las Skills no es la automatización del trabajo sino la «capitalización del juicio». El acto de verbalizar tus criterios de juicio y configurarlos en la IA.
Para aquellos que encontraron este artículo incluso ligeramente útil.
El Laboratorio Claude Code de la Universidad de Tokio (@ClaudeCode_UT) es una cuenta que publica diariamente, centrada en miembros que son entusiastas incondicionales de Claude Code y estudiantes actuales de la UTokyo.
Entregamos información y conocimientos «verdaderamente útiles» especializados para el negocio práctico todos los días.
Siguiéndonos, puedes obtener información como esta 👇
- Guías prácticas para «técnicas para hacer que la IA aprenda el trabajo» como Skills y CLAUDE.md
- Explicaciones de los temas más recientes de uso de IA del extranjero para no ingenieros
- Este es el único lugar donde puedes recibir habilidades de Claude Code «verdaderamente útiles» de forma gratuita
Si estás interesado, ¡por favor síguenos y échale un vistazo! 👀
Además, hemos iniciado una LINE oficial, así que si quieres obtener información limitada rápidamente, ¡únete! ¡Acerquemos nuestro aprendizaje y superemos juntos la era de los agentes de IA! ❗️
