Inicio

Cree su primera Claude Skill

Ha estado escribiendo manualmente /stock-report AAPL para generar informes. ¿Y si Claude pudiera decidir automáticamente cuándo crear un informe bursátil según su conversación? Ese es el poder de las Skills: es como cambiar de una transmisión manual a una automática que cambia de marcha cuando es necesario.

Conceptos clave

• Skill - Capacidad invocada por el modelo, almacenada en .claude/skills/, que Claude activa automáticamente según el contexto
• Invocación por modelo - Claude decide cuándo usar la Skill leyendo su descripción, sin necesidad de escribir un comando
• Sigue siendo un comando slash - También puede ejecutar cualquier Skill usted mismo escribiendo /nombre-de-la-skill (por ejemplo /stock-report AAPL). Si una Skill y un comando slash tienen el mismo nombre, se usa la Skill
• SKILL.md - Archivo principal que contiene metadatos YAML e instrucciones para Claude

Lo que necesitará

• Haber completado: Crear Comandos Slash Personalizados
• Comando slash stock-report de ese tutorial
• VS Code instalado
• 10-15 minutos

Paso 1: Navegue hasta la carpeta del proyecto

Windows (PowerShell):

• Abra PowerShell desde el menú Inicio
• Ejecute:

  cd ~\Documents\test_claude
  

  Si la carpeta no existe, créela primero:

  mkdir ~\Documents\test_claude
  cd ~\Documents\test_claude
  

Mac:

• Abra Terminal (Aplicaciones > Utilidades)
• Ejecute:

  cd ~/Documents/test_claude
  

  Si la carpeta no existe, créela primero:

  mkdir -p ~/Documents/test_claude
  cd ~/Documents/test_claude
  

Paso 2: Inicie Claude Code

Ejecute:

claude

Paso 3: Permita que Claude edite archivos sin preguntar

Mire la línea de estado justo debajo del prompt de Claude Code:

• Si dice auto mode on o accept edits on, todo está listo
• Si dice manual mode on, presione Shift+Tab hasta que diga accept edits on

Esto permite que Claude cree y modifique archivos sin solicitar permiso cada vez.

Paso 4: Pídale a Claude que convierta el comando slash

Escriba este prompt:

Convierte mi comando slash stock-report en una Skill.
La Skill debe activarse automáticamente cuando pregunte sobre empresas o acciones.

Claude analiza su comando slash existente y lo convierte en una Skill en .claude/skills/stock-report/.

Lo que sucede: Claude crea una nueva estructura de carpetas con SKILL.md que contiene metadatos YAML que indican a Claude cuándo usar esta Skill automáticamente.

Paso 5: Revise la estructura de la Skill

Abra VS Code y vea el proyecto:

• Haga clic en File > Open Folder
• Seleccione Documents/test_claude
• En el explorador de archivos, navegue hasta .claude/skills/stock-report/
• Haga clic en SKILL.md para abrirlo

Observe la estructura:

---
name: stock-report
description: Genera informes sobre empresas... Usar cuando los usuarios pregunten sobre acciones, empresas o símbolos bursátiles.
---

[Resto de las instrucciones]

El campo description es clave: le indica a Claude exactamente cuándo activar esta Skill automáticamente.

Paso 6: Pruebe la Skill (sin escribir un comando)

Primero, asegúrese de que Claude Code haya cargado la nueva Skill. Escriba:

/reload-skills

Claude Code informa cuántas Skills están disponibles. Ahora, en lugar de escribir /stock-report AAPL, simplemente haga una pregunta natural:

¿Qué está pasando con Apple últimamente?

La diferencia clave: No escribió un comando. Claude lee su pregunta, reconoce que está preguntando sobre una empresa, revisa las descripciones de las Skills y decide automáticamente usar la Skill stock-report.

Observe cómo trabaja Claude: debería generar el mismo informe completo que vio antes.

Paso 7: Compare los dos enfoques

Comando Slash (manual):

/stock-report AAPL

• Usted le dice explícitamente a Claude qué hacer
• Siempre funciona igual
• Útil para tareas repetitivas y predecibles

Skill (automática):

Cuéntame sobre los desarrollos recientes de Tesla

o

Estoy pensando en invertir en Microsoft

o

¿Qué está haciendo NVIDIA?

• Claude decide si usar la Skill
• Conversación más natural
• Útil para flujos de trabajo complejos que Claude administra por usted

Paso 8: Pruebe casos límite

Pruebe preguntas que NO deberían activar la Skill de informe bursátil:

¿Cómo instalo Python?

Claude responde normalmente sin invocar la Skill.

Ahora pruebe una pregunta que SÍ debería activarla:

Compara Google y Meta

Claude debería usar la Skill dos veces: una para Google y otra para Meta.

Paso 9: Modifique la descripción de la Skill (opcional)

Hagamos que la Skill sea más selectiva. Pídale a Claude:

Actualiza la Skill stock-report para que solo se active cuando mencione explícitamente
"analizar" o "informe" junto con el nombre de una empresa.

Claude actualiza el campo description en SKILL.md. Escriba /reload-skills para que Claude Code detecte el cambio y luego pruebe la diferencia:

¿Qué está haciendo Apple?

(Puede que no active la Skill ahora)

Analiza Apple

(Debería activar la Skill)

Próximos pasos

Ahora que comprende las Skills, cree más para sus flujos de trabajo:

• Research Skill - Se activa automáticamente cuando hace preguntas que requieren búsqueda web
• Code Review Skill - Se activa cuando menciona errores o problemas de código
• Meeting Notes Skill - Se activa cuando pega transcripciones de reuniones o menciona resúmenes

El patrón: defina cuándo Claude debe ayudar automáticamente, no solo atajos que usted activa manualmente.

Solución de problemas

• La Skill no se activa: Verifique el campo description en SKILL.md: debe incluir palabras clave relacionadas con su pregunta
• La Skill se activa con demasiada frecuencia: Haga la descripción más específica sobre cuándo usarla
• No encuentra la carpeta de la Skill: Las Skills están en .claude/skills/ (una carpeta oculta: el Explorer de VS Code la muestra; o bien, en File Explorer de Windows elija View > Show > Hidden items; en Finder de Mac presione Cmd+Shift+.)
• Los cambios en SKILL.md no funcionan: Las Skills normalmente se recargan automáticamente al modificarse. Si la carpeta .claude/skills/ se creó durante esta sesión, escriba /reload-skills (o reinicie Claude Code). Si persiste el problema, verifique el formato YAML

Resumen del flujo de trabajo

• Los comandos slash son atajos que usted escribe manualmente (como marcadores)
• Las Skills son capacidades que Claude descubre y usa automáticamente (como un asistente que conoce sus preferencias)
• Las descripciones de Skills actúan como instrucciones que indican a Claude: “Úsame cuando el usuario diga X”
• Ambos pueden coexistir - Use comandos slash para tareas rápidas y repetitivas; use Skills para flujos de trabajo complejos
• Las Skills escalan mejor - No necesita recordar nombres de comandos; Claude decide según el contexto

Creado por Steven Ge el 13 de diciembre de 2025.