"Me preocupa si puedo usar IA porque no tengo ningún conocimiento de programación…"
"Me da miedo mirar la pantalla negra del terminal y no me siento con ganas."
"Pero me da ansiedad quedarme atrás por la tendencia de la IA 😱"
Incluso en ese estado, al dejar que Claude Code aprenda mis "propios patrones de acción", una tarea que solía tomar 30 minutos cada vez ahora toma 5 minutos.
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 fondo yo mismo.
- Aunque es IA, hay mucho trabajo manual. "¿No es esto igual 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.
Para 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 de Skills en español que actualmente se está volviendo viral con más de 580,000 vistas.
É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ó por completo cómo trabaja con Claude.
Tengo dos peticiones antes de empezar.
- Guarda este artículo y asegura 20 minutos esta semana.
- Si conoces a alguien que use Claude Code, compártelo con esa persona.
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, déjame hablar sobre la premisa principal.
Claude Code es muy inteligente. Sin embargo, no conoce "tu forma de trabajar".
Esto no es un problema de rendimiento, sino una cuestión de cómo funciona.
Claude comienza desde cero cada vez que abres una nueva sesión. A menos que le 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á configurado, 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 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 Configuración se Acumula
Escribir especificaciones de formato, explicar criterios de juicio y compartir información de fondo.
¿Cuánto tiempo pasas en esta "configuración" en un día? Aunque estés usando IA, te cansas solo de la preparación.
santtiagom_ escribe:
"¿Qué pasaría si pudieras escribir una instrucción una vez y que se haga perfectamente a partir de entonces sin dar instrucciones de nuevo? De eso se tratan las Skills."
Las Skills son 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é el panorama 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".
Creas un archivo llamado SKILL.md y lo configuras en Claude.
Entonces, Claude actuará de acuerdo a esas instrucciones cada vez que abra una sesión. Ya no necesitas configurar 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 se ajustan al proyecto
Lo importante es que tu trabajo también tiene "tareas que se pueden convertir en MT".
Por ejemplo, al hacer un informe:
"Escribe la conclusión primero. Usa no 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 acción a seguir." Esto también.
Comparemos un mundo con Skills y un mundo sin ellas.
[Sin Skills]
Pides "crear un informe semanal" → Claude produce en su propio formato → Lo corriges: "No, 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 produce según las Skills → Desde el principio, está en el formato "Conclusión → 3 Puntos de Datos → Problemas" → Las correcciones son casi cero.
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 escribirla.
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 conversión del juicio en un activo. 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 debería usarse".
Claude mira esta "portada" y juzga "si debería usar esta Skill para la tarea actual". Si esto es ambiguo, Claude no encontrará la Skill que te esforzaste en 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 para un 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 de trabajar real.
Escribes procedimientos y reglas específicas como "Escribe en este orden", "Sigue este formato" y "Asegúrate de verificar solo este punto".
Las Skills funcionan con solo 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 (resultado esperado 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 tratos en tres niveles: A/B/C12- Limita los problemas a uno y agrega una acción específica de una línea 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". Siempre conviértelo en "qué se hará y para cuándo"
Este es el panorama general de SKILL.md.
Al ver 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 que comienza con la conclusión en el mismo formato cada vez.
Reglas como "Las Reglas del Gerente Tanaka", que solo aplican en tu lugar de trabajo, son el verdadero valor de las Skills. Por más 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". Usa esto 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í sola sin que des ninguna instrucción.
Si se convierte en una Skill más grande, puedes agregar carpetas auxiliares para materiales de referencia y plantillas, pero un 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 en 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 descripción" de todas las Skills. Todavía 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 se cargan realmente "1 o 2 relacionadas con el trabajo actual". Casi no tiene 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 relevante 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 se debe usar esta Skill".
Como guía práctica, no hay ningún problema siempre y cuando el total de todos los nombres y descripciones de las Skills esté dentro de los 15,000 caracteres. Es muy 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 al menos una de las siguientes tres condiciones aplica, es momento para una Skill:
- Hay información de fondo que estás escribiendo manualmente (formato, reglas, tono, etc.)
- Hay una tarea que quieres 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 fondo 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 correos electrónicos. Si hay información de fondo que escribes cada vez, esa es una señal de que debería 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 de ella, y coloca el archivo SKILL.md allí.
1.claude/skills/2 └── informe-semanal/3 └── SKILL.md
Eso es todo lo que necesitas para prepararte.
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 apuntes 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 a partir de 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", puedes simplemente agregar eso 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 la Skill desactivada.
Si hay una diferencia clara en el resultado, es 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 agregar criterios de juicio que solo tú conocerías.
5️⃣ Las Skills crecen cada vez que fallan
Si sientes que "esta parte todavía está mal" después de la prueba, agrega eso a SKILL.md cada vez.
Para tomar prestadas las palabras de santtiagom_, "Si has hecho la misma corrección 3 veces, agrégala 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 responde con "Sería más eficiente hacerlo de esta manera". Este ciclo es la diversión y la fortaleza de las Skills.
3 Señales de Alerta para Cultivar Skills Útiles
Una vez que has 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, ten cuidado con 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 descripción" en el Nivel 1. Si la descripción aquí es ambigua, será omitida como "no parece relevante esta vez".
Verifica si la descripción deja claro de un vistazo "cuándo y para qué tarea se debe usar".
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 sí solo 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 superan los 3 puntos", "Se enoja 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 introducir.
① Claude es inteligente. No es necesario enseñarle lo que ya sabe.
Instrucciones generales como "produce 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 es bueno. 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 el uso a largo plazo es mantener el cuerpo de SKILL.md enfocado solo en las instrucciones principales.
③ Prueba con casos reales, no con ideales
Probar con una solicitud ficticia no tiene sentido. Inténtalo con un trabajo que realmente hagas los lunes usando Skills. Es en el trabajo real donde verás las instrucciones que faltan.
④ Hazlo crecer mientras lo usas en lugar de apuntar a la perfección
Si haces la misma corrección 3 veces, agrégala a SKILL.md. Esta repetición es la ruta más corta para cultivar 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 quieren "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 estas son hechas por terceros, recomiendo verificar el contenido antes de usarlas. Existe la posibilidad de que contengan cosas riesgosas, así que presta mucha atención allí.
2️⃣ Hay dos ubicaciones de almacenamiento: para ti mismo y para el equipo
Las Skills tienen dos ubicaciones de almacenamiento.
Solo para ti:
Si la colocas en .claude/skills/ en tu carpeta de inicio, se convierte en una Skill dedicada a ti que se puede usar independientemente del proyecto que abras.
Para compartir en equipo:
Si la colocas en .claude/skills/ dentro de un proyecto, se incluye en el control de versiones, por lo que todos en el equipo pueden usar la misma Skill.
Personalmente, creo que este intercambio 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, este es un uso avanzado para ingenieros. Recomiendo comenzar con los 6 pasos básicos presentados en la sección anterior.
Resumen
Resumiré los puntos de este artículo en 6 ítems. Por favor, guárdalo para que puedas volver a 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 conversión del juicio en un activo". El acto de verbalizar tus criterios de juicio y configurarlos en la IA.
Para aquellos que encontraron este artículo incluso un poco útil.
El Laboratorio de Claude Code de la Universidad de Tokio (@ClaudeCode_UT) es una cuenta que publica diariamente, centrada en miembros que son entusiastas acérrimos de Claude Code y estudiantes actuales de la Universidad de Tokio.
Entregamos información y conocimientos "genuinamente útiles" especializados para el negocio práctico todos los días.
Al seguirnos, 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 "genuinamente útiles" de forma gratuita
Si estás interesado, ¡por favor síguenos y échale un vistazo! 👀
Además, hemos iniciado un LINE oficial, así que si quieres obtener información limitada rápidamente, ¡únete! ¡Aceleremos nuestro aprendizaje y superemos juntos la era de los agentes de IA! ❗️
