JAL — Ingeniería · Avalúos · Construcción
Ing. Jorge Alberto Luna Soto
C.P. No. 1007279
R.F.C. LUSJ600708GG2
S.S.A. JIC-00-389/91
D.R.O. No. 185
MANUAL PRÁCTICO

CÓMO ELABORAR, ARCHIVAR Y USAR UN SKILL

Caso de estudio: Skill membrete-JALL
Un buen Skill se construye una sola vez y se aprovecha cada vez que se necesita: la misma calidad, el mismo membrete, sin repetir el trabajo.

1. Qué es un Skill

Un Skill es una carpeta con instrucciones, archivos y, si hace falta, pequeños programas que le enseñan a Claude a hacer una tarea siempre de la misma manera. Claude lo consulta solo cuando tu petición coincide con lo que el Skill dice hacer.

El Skill membrete-jall es un ejemplo completo: guarda tu membrete (logotipo, datos profesionales, pie de página), los colores y tipografías, y dos generadores. Con él, un documento nuevo sale en PDF o en HTML de lujo con tu identidad profesional, sin explicar el diseño cada vez.

2. Antes de empezar

3. Cómo elaborar un Skill

Método A: pedirle a Claude que lo cree (el más fácil)

Método B: armarlo a mano

Un Skill es una carpeta cuyo nombre va en minúsculas y con guiones, por ejemplo membrete-jall. Debe tener un archivo llamado SKILL.md y, opcionalmente, subcarpetas de apoyo:

Archivo o carpetaPara qué sirve
SKILL.mdObligatorio. Lleva el nombre, la descripción (cuándo usarlo) y las instrucciones paso a paso
scripts/Programas que generan los documentos: build_documento.py (PDF), build_html.py (HTML de lujo) y verificar_membrete.py (revisa márgenes y centrado)
assets/Archivos que se reutilizan: logotipo, íconos del pie, ejemplo en JSON y el PDF original
references/membrete.mdDatos, colores, medidas y tipografías del membrete, para consulta

El encabezado de SKILL.md es lo más importante. Lleva dos líneas entre guiones: name (el nombre) y description. La descripción debe decir qué hace el Skill y en qué situaciones usarlo, incluyendo las palabras que tú dirías (“con mi membrete”, “carta”, “reconocimiento”, “informe técnico”). Si la descripción es vaga, Claude no sabrá cuándo usarlo.

Buenas prácticas

4. Cómo archivarlo para usarlo después

Tu Skill es un archivo (membrete-jall.skill). Guárdalo como cualquier documento importante:

5. Cómo instalarlo y activarlo

Si en la app del iPhone no ves la opción de subir archivos de Skills, hazlo una sola vez desde claude.ai en el navegador. Después el Skill queda disponible en tu cuenta, también en el celular.

6. Cómo usar el Skill membrete-JALL

Basta pedirlo con tus palabras y, para mayor seguridad, mencionarlo por su nombre. Ejemplos:

FormatoCuándo usarlo
PDF cartaImprimir, archivar o enviar como documento formal. Es el formato predeterminado
HTML de lujoVerlo con presencia en pantalla del iPhone o la computadora, compartirlo como archivo, o imprimirlo desde el botón “Imprimir / Guardar PDF”
Imagen PNGMandarlo rápido por WhatsApp desde el iPhone

Ruta de trabajo recomendada: pide el borrador, corrígelo conversando (“hazlo más breve”, “agrega su maestría”), y cuando esté a tu gusto escribe “dame el documento final”. Claude genera el archivo con tu membrete, lo revisa visualmente y te lo entrega.

7. Cómo actualizarlo o eliminarlo

8. Si algo no funciona

SíntomaCausa probableQué hacer
Claude no usa el SkillEstá desactivado o la petición no lo mencionaActívalo en Skills y nómbralo: “usa mi Skill membrete-jall”
No aparece la opción de subirFalta activar la ejecución de código y creación de archivosActívala en Configuración > Capacidades; en cuentas de equipo, pídela al administrador
Error al subir el archivoFalta SKILL.md dentro de la carpeta o está mal comprimidaRevisa el contenido; prueba con la copia .zip
Sale una versión antiguaSigue instalada la versión anteriorReemplázala o desactívala y sube la nueva
No se ve el membreteQuedó incompleta la carpeta assetsPide a Claude reempaquetar el Skill completo

9. Lista de verificación rápida

“Lo que se hace bien una vez y se archiva con orden, se puede repetir con calidad todas las veces que haga falta.”
Ing. Jorge A. Luna Soto
Director Responsable de Obra No. 185