Cómo se instala un paquete de skills

Cómo se instala un paquete de skills

Ya armaste varias skills sueltas a lo largo del curso: cada una en su propia carpeta, cada una resolviendo un problema puntual. El siguiente paso es juntarlas en un paquete, instalarlas todas de una vez y, quizás, pasárselas a alguien más de tu equipo. Ahí aparece un problema distinto: ¿dónde van los archivos exactamente? ¿Cómo confirmas que una skill que no escribiste tú es segura? ¿Y si algo sale mal, cómo la quitas? Esta lección responde las tres preguntas.

Qué es un paquete de skills

Un paquete es simplemente una carpeta que agrupa una o varias skills. Cada skill vive en su propia subcarpeta, con su archivo SKILL.md (el archivo que le dice a Claude cuándo debe usar esa skill y qué pasos seguir) y, si hace falta, archivos de apoyo: una plantilla, una lista de verificación, un ejemplo de salida. Un paquete no es un programa que se instala y corre solo: es texto que Claude lee cuando lo necesita. Eso significa dos cosas importantes: puedes leer exactamente qué hace antes de confiar en ella, y no hay nada "oculto" corriendo en segundo plano.

La carpeta típica de un paquete se ve así:

• paquete-cierre-de-mes/
•   cuadre-de-caja/SKILL.md
•   reporte-de-gastos/SKILL.md
•   recordatorio-de-pagos/SKILL.md

Instalar un paquete en Claude (web, escritorio y móvil)

Según tu plan, en los ajustes de Claude hay una sección de capacidades donde puedes subir skills comprimidas en formato .zip. La ubicación exacta cambia con cada actualización de la interfaz, así que confírmala en la página oficial de ayuda de Claude si no la encuentras donde la buscaste la última vez. El procedimiento general es este:

1. Comprime cada carpeta de skill por separado en un archivo .zip. No comprimas el paquete entero de una sola vez: cada skill se sube como su propio archivo.
2. Entra a los ajustes de tu cuenta y busca la sección de capacidades o skills.
3. Sube el .zip de la primera skill y espera a que la interfaz confirme que quedó instalada.
4. Repite con cada skill del paquete.
5. Ábrela en una conversación nueva y pídele a Claude una tarea sencilla que la use, solo para comprobar que responde.

Instalar un paquete en Claude Code

Si usas Claude Code (la herramienta que trabaja directamente con las carpetas y archivos de tu computadora desde la terminal, o dentro de la app de escritorio), instalar una skill es copiar su carpeta a un lugar específico. Hay dos lugares posibles, y la diferencia importa:

• Carpeta del usuario: la skill queda disponible en cualquier proyecto que abras desde esa computadora.
• Carpeta del proyecto: la skill solo funciona dentro de ese proyecto puntual, y puedes compartirla junto con los archivos del proyecto.

En ambos casos, la carpeta con el SKILL.md tiene que quedar dentro de la carpeta de skills correspondiente, respetando el nombre de la skill como nombre de subcarpeta. Si copias mal la estructura (por ejemplo, dejas el SKILL.md suelto sin su subcarpeta), Claude Code no la va a reconocer.

Revisar un paquete antes de instalarlo

Cuando el paquete lo escribiste tú, ya conoces qué hace. Cuando te lo pasa otra persona, revisarlo antes de instalarlo no es opcional. Abre el SKILL.md y cualquier archivo que lo acompañe, y léelos completos antes de subir nada. Presta atención a estas señales de alerta:

• Pide que pegues contraseñas, llaves de acceso, números de tarjeta o cualquier dato que normalmente no compartirías con nadie.
• Pide ejecutar comandos que no entiendes o instalar programas adicionales.
• Menciona conectarse a una dirección web que no reconoces o que no tiene relación con lo que la skill dice hacer.
• La descripción es vaga: no queda claro qué hace exactamente ni cuándo se activa.

Si algo de eso aparece, no la instales. Pídele explicación a quien te la compartió o descártala directamente. Una skill legítima puede explicar en una o dos frases qué hace y por qué necesita lo que pide.

Para desactivar o borrar una skill que ya instalaste: en Claude, vuelve a la sección de capacidades de los ajustes y quítala desde ahí. En Claude Code, borra su carpeta de la ubicación donde la copiaste. En los dos casos, el cambio es inmediato: la próxima conversación ya no la va a usar.

Ejemplo

Una contadora en Asunción recibe de una colega un paquete con tres skills pensadas para el cierre de mes: una para el cuadre de caja, otra para armar el reporte de gastos y una tercera para los recordatorios de pago a proveedores. Antes de instalar nada, abre las tres carpetas y lee cada SKILL.md.

Las dos primeras describen con claridad qué archivos piden como entrada y qué entregan como salida: una tabla de cuadre y un reporte en texto. La tercera es distinta: entre sus instrucciones incluye un paso que dice "pega aquí el usuario y la contraseña del portal del banco para revisar pagos pendientes". Eso es exactamente la señal de alerta que ninguna skill legítima debería pedir: una contraseña de una cuenta bancaria no tiene por qué pasar por un chat.

La contadora descarta esa tercera skill, le escribe a su colega para avisarle por qué, e instala solo las otras dos siguiendo los pasos de esta lección: comprime cada una por separado, las sube desde los ajustes de capacidades y prueba cada una con datos de un mes cerrado antes de usarlas con el mes en curso.

Errores comunes

• Instalar sin leer el SKILL.md. Es el único momento en que puedes revisar qué hace la skill antes de dejarla activa. Sáltatelo y estás confiando a ciegas.
• Subir el paquete entero como un solo archivo .zip en Claude. Cada skill se sube por separado; un .zip con varias carpetas dentro no se instala correctamente.
• Dejar activas skills que ya no usas. Se acumulan, compiten entre sí por activarse en la conversación equivocada y hacen más difícil encontrar la que necesitas.
• Compartir una skill con datos reales pegados adentro. Si tu skill de propuestas tiene el nombre y el correo de un cliente real dentro de un ejemplo, bórralos antes de pasársela a alguien más. Usa datos genéricos o marcados con corchetes.
• No probarla antes de confiar en ella. Una skill recién instalada se prueba con una tarea de bajo riesgo antes de usarla para algo que le llega directo a un cliente.

Tu tarea

1. Reúne en una sola carpeta todas las skills que ya creaste en el curso, cada una en su propia subcarpeta con su SKILL.md.
2. Escribe un archivo de texto llamado LEEME con el nombre de cada skill y una frase de qué hace.
3. Antes de seguir, pídele a Claude que revise cada SKILL.md con el prompt de abajo, para practicar el hábito de revisar antes de confiar.
4. Desinstala las skills desde donde las tenías (los ajustes de capacidades o la carpeta de skills, según dónde las usas).
5. Instálalas de nuevo desde cero siguiendo los pasos de esta lección y corre cada una una vez para comprobar que responde igual que antes.

Actúa como revisor de seguridad. Voy a pegarte el contenido de un archivo SKILL.md que me compartió otra persona. Dime en una lista:
1) qué hace la skill, en una frase,
2) si pide algún dato sensible (contraseñas, llaves de acceso, números de tarjeta, datos personales de un tercero),
3) si pide ejecutar algún comando o conectarse a una dirección externa,
4) tu recomendación: instalarla, instalarla con cuidado revisando primero un punto concreto, o no instalarla.

Aquí está el archivo:

[pega aquí el contenido del SKILL.md]