FreeAILab free-ai-lab

Guía de escritura de SKILL.md

Tutorial avanzado

Guía de campos + 10 plantillas listas para copiar + consejos avanzados para que los Skills sean más estables.

En una frase: Un SKILL.md son solo tres partes: la cabecera "le dice a la IA quién eres y cuándo usarlo", el cuerpo es "exactamente cómo hacerlo", y los ejemplos muestran "cómo se ve el resultado". Este artículo desglosa cada campo y luego te da 10 plantillas que puedes copiar directamente.

Para principiantes absolutos, empieza con el tutorial de creación en cuatro pasos; este artículo es la referencia avanzada.

Visión general de la estructura

--- name: skill-name ← id en minúsculas con kebab-case description: qué hace + cuándo usarlo ← lo más crítico; la IA juzga la activación según esto --- # Título principal (cuerpo: pasos, reglas, límites) ## Ejemplos (entrada → salida, para mostarle a la IA a qué aspirar)
frontmatter (cabecera)

name + description, en formato YAML

Cuerpo

pasos concretos + límites + reglas; cuanto más específico, más estable

Ejemplos

entrada → salida ideal, fijando el estándar que la IA debe producir

Escribir los mejores campos de cabecera

description es la clave

Decide "cuándo la IA recuerda este Skill". Cuanto más se parezca a las palabras del propio usuario, mayor será la tasa de acierto.

❌ Demasiado vago (la IA no sabrá cuándo usarlo)
description: Ayuda a escribir textos publicitarios
✅ Preciso (cobertura completa de escenarios de activación)
description: Escribe publicaciones de notas de producto al estilo de contenido viral breve. Úsalo cuando el usuario diga "escribe una publicación para redes sociales", "ayúdame a redactar una pieza promocional del producto" o pegue información del producto.
Convención de nombres en name

Letras minúsculas + guiones (p. ej., weekly-report-writer), para que su función sea obvia de un vistazo. No uses espacios, mayúsculas ni caracteres no latinos.

10 plantillas de escenarios listas para copiar

Guarda cualquiera de las siguientes como carpeta (que contenga un SKILL.md con el mismo nombre) y funcionará — solo cambia los ejemplos:

1️⃣ Skill de notas de reunión
--- name: meeting-notes description: Convierte transcripciones de reuniones en actas estructuradas. Úsalo cuando el usuario pegue notas de reunión o diga "organiza la reunión de hoy". --- # Acta de reunión 1. Primero identifica y muestra: tema, hora, asistentes 2. Organiza en tres secciones: "decisiones / tareas pendientes / cuestiones abiertas" 3. Una tarea por persona, formato: responsable + qué hacer + fecha límite (la información que falte marcada como [TBD]) 4. No añadas información que no esté en las notas ## Ejemplo Entrada: En la reunión de hoy se decidió añadir una función de exportación al producto; yo soy responsable del backend, Xiao Zhang del frontend, demo para el viernes... Salida: ### Decisiones - Añadir una función de exportación al producto ### Tareas pendientes - Ming: implementación de la exportación en el backend (plazo [TBD])
2️⃣ Skill de pulido de email (tono de empresa)
--- name: email-polisher description: Reescribe borradores de email toscos en emails de empresa profesionales. Úsalo cuando el usuario pegue un borrador de email o diga "pule mi email". --- # Pulido de email 1. Conserva todos los puntos de información clave 2. Mejora la etiqueta del saludo, la apertura y el cierre 3. Divide las frases largas; una idea por párrafo 4. Salida: email pulido + resumen de cambios en 3 líneas o menos ## Ejemplo Entrada: Hola jefe, la colaboración que hablamos está confirmada, ¿cuándo quieres firmar? Salida: Estimado Sr. Wang, respecto a la colaboración comentada anteriormente, hemos confirmado que seguimos adelante. Por favor, indíquenos cuándo le vendría bien y podremos organizar la firma a su conveniencia. ¡Saludos cordiales!
3️⃣ Skill de informe semanal
--- name: weekly-report description: Convierte registros de trabajo dispersos en un informe semanal claro y estructurado. Úsalo cuando el usuario pegue un batiburrillo de notas o diga "escribe mi informe semanal". --- # Generación de informe semanal 1. Ordena las notas en "resultados de esta semana / problemas encontrados / planes de la próxima semana" 2. Ordena los resultados por importancia, cada uno con datos de apoyo (añade [TBD] si faltan) 3. Ofrece 2 títulos sugeridos para elegir 4. Cíñete a los hechos; no inventes acontecimientos que no ocurrieron ## Ejemplo…
4️⃣ Skill de pulido de currículum
--- name: resume-polisher description: Pule las descripciones del currículum para que sean más profesionales y cuantificables. Úsalo cuando el usuario pegue un currículum o diga "optimiza mi currículum". --- # Pulido de currículum 1. Empieza con verbos de acción (p. ej., "lideré", "implementé"), evita la primera persona 2. Cuantifica los resultados cuando sea posible (números, porcentajes); conserva el original si no hay 3. Mantén cada entrada de experiencia en 1–2 líneas; recorta lo superfluo y de relleno 4. Salida: lista pulida + una nota sobre qué cambió y por qué
5️⃣ Skill de revisión de código front-end
--- name: frontend-code-review description: Revisa el código front-end en busca de mantenibilidad y accesibilidad. Úsalo cuando el usuario diga "revisa este código" o pegue código. --- # Revisión de código front-end 1. Comprueba cada elemento: legibilidad / accesibilidad (aria) / rendimiento (renderizados repetidos) / seguridad (XSS) 2. Por cada problema, da: archivo + línea, el problema y el código de la solución sugerida 3. Ordena la salida por gravedad 4. Si no hay problemas, di claramente "no se encontraron problemas"
6️⃣ Skill de generación de prompts de imagen
--- name: image-prompt-writer description: Convierte una descripción de escena en un prompt de generación de imágenes IA en inglés de alta calidad. Úsalo cuando el usuario diga "escríbeme un prompt de imagen". --- # Prompt de generación de imagen 1. Salida en inglés, estructurada: sujeto + entorno + iluminación + composición + estilo + etiquetas de calidad 2. Termina con etiquetas de calidad fijas: high quality, 4k 3. Elige automáticamente un descriptor de estilo apropiado según la escena (realista / ilustración / 3D / póster) 4. Tras el prompt, añade una explicación de 2 líneas
7️⃣ Skill de organizador de notas de estudio
--- name: study-notes description: Organiza materiales de estudio dispersos en notas estructuradas y tarjetas de memoria. Úsalo cuando el usuario pegue materiales o diga "organiza mis notas de estudio". --- # Notas de estudio 1. Extrae los conceptos clave, empezando cada uno con una "definición en una frase" 2. Organiza jerárquicamente por tema, añadiendo ejemplos 3. Genera 5 tarjetas de memoria de preguntas/respuestas 4. Salida en Markdown apto para importar en una app de notas
8️⃣ Skill de interpretación de análisis de datos
--- name: data-interpreter description: Interpreta un conjunto de datos (tabla/números) y da conclusiones y recomendaciones. Úsalo cuando el usuario pegue datos o diga "analiza estos datos". --- # Interpretación de datos 1. Resume primero la imagen general y luego enumera las tendencias/valores atípicos notables 2. Distingue "hechos de los datos" de "inferencias"; etiqueta cualquier inferencia 3. Da 3 o más sugerencias de siguientes pasos accionables 4. Muestra las comparaciones en forma de tabla
9️⃣ Skill de guion de vídeos cortos
--- name: short-video-script description: Convierte un tema en un guion de vídeo corto hablado de 30–60 segundos. Úsalo cuando el usuario diga "escribe un guion de vídeo corto" o "convierte este texto en un guion de vídeo". --- # Guion de vídeo corto 1. Estructura: gancho de 3 segundos + núcleo de 15 segundos + llamada a la acción final 2. Hazlo hablado: frases cortas, tono casual, marcas de pausa 3. Da una pista visual cada 10 segundos (plano / subtítulo) 4. Mantén la duración por debajo de los 45 segundos, unas 300 palabras
🔟 Skill de planificación de viajes
--- name: travel-planner description: Produce un itinerario de viaje según duración/presupuesto/preferencias. Úsalo cuando el usuario diga "ayúdame a planificar un viaje" o "hazme una guía de viaje". --- # Planificación de viajes 1. Primero confirma las entradas: número de días, presupuesto, origen y destino, preferencias (comida / naturaleza / cultura) 2. Programa cada día mañana/mediodía/tarde: atracciones + transporte + comidas 3. Marca el tiempo de estancia previsto en cada atracción 4. Incluye: una tabla de presupuesto estimado + 3 consejos prácticos (como reservas/clima)

La mentalidad de las plantillas: convertir "flujos de trabajo repetidos de alta frecuencia" en un Skill es un uso más avanzado que guardar prompts en marcadores — instálalo una vez y la IA seguirá tu estándar cada vez a partir de entonces.

Consejos avanzados: hacer los Skills más estables

  • Añade "contraejemplos": escribir "no hagas X" en el cuerpo reduce notablemente los excesos (p. ej., "no inventes datos", "no cambies nombres cuando no estés seguro")
  • Especifica el formato de salida: exige explícitamente "forma de tabla", "encabezados ###", "3 líneas o menos" — la estructura de salida de la IA se vuelve más estable
  • Ancla con ejemplos al final: los ejemplos no son solo decorativos; son la referencia que alinea a la IA con el estándar de producción
  • Usa scripts/ para el trabajo mecánico: deja el cálculo y el formateo repetidos a los scripts; SKILL.md solo "dirige"
  • Pule de forma iterativa: prueba 3 entradas → añade al cuerpo los lugares donde la IA erró → vuelve a probar; los Skills se vuelven más precisos cuantos más los usas

Lecturas relacionadas