Cómo convertir una tarea de IA funcional en una Skill reutilizable
Transforma un prompt puntual en un SKILL.md reutilizable. Separa las entradas dinámicas de las reglas estándar, prueba los casos límite y comparte el flujo de trabajo con tu equipo.
Una vez que tienes un informe semanal de GitHub que puedes usar, probablemente quieras que el siguiente siga las mismas reglas: filtrar por fecha de merge, conservar los enlaces de origen y dejar visible el contexto faltante. Guardar esas reglas hace que sean más fáciles de reutilizar y revisar que copiar una conversación larga cada semana.
En Leina, puedes empaquetar flujos de trabajo probados en una Skill: un archivo SKILL.md estructurado que sigue la especificación abierta Agent Skills. En lugar de volver a explicar los estándares de informes de tu equipo cada lunes, proporciona el repositorio actual, las fechas, la zona horaria y cualquier destino que necesite la tarea.
Usa un informe que ya hayas revisado como punto de partida. El recorrido de GitHub a Notion muestra cómo preparar y revisar uno.
Separa las entradas cambiantes de las reglas estándar
Una Skill fiable separa las entradas para esta ejecución de las reglas que se reutilizan.
| Entradas para esta ejecución | Reglas guardadas en SKILL.md |
|---|---|
| Repositorio o lista de repositorios objetivo | Reglas de filtrado exactas (timestamp de merge vs. fecha de cierre) |
| Ventana de informe y zona horaria | Requisito de cita de la fuente (incluir enlace del PR y autor) |
| URL de la página de destino en Notion, para una escritura | Reglas de evidencia (marcar el contexto faltante como no documentado) |
| Audiencia prevista / nivel de detalle | Instrucciones de escritura (respetar el alcance solicitado y comprobar el contenido existente) |
Las credenciales y los tokens de acceso nunca deben estar en un archivo de Skill. Leina gestiona el acceso a través de Connections autorizadas; una Skill simplemente define cómo debe usar el agente las herramientas disponibles en tu entorno.
Estructura tu archivo SKILL.md
Un archivo SKILL.md tiene frontmatter YAML e instrucciones en Markdown. Esta plantilla inicial es un ejemplo para adaptar y probar con tus herramientas disponibles; no se ha ejecutado contra tus cuentas.
---
name: weekly-pr-report
description: "Preparar un informe semanal de solicitudes de extracción de GitHub vinculado a fuentes para un repositorio y una ventana de tiempo especificados, con una escritura autorizada opcional en Notion. Usar para informes de estado de ingeniería, no para revisión de código ni puntuación de productividad individual."
---
# Informe semanal de PR
Instrucciones de ejemplo para adaptar y evaluar con las herramientas disponibles en el entorno del agente. Este archivo no instala conectores ni otorga acceso a cuentas.
## Entradas
Resolver la lista de repositorios, la ventana de informe con zona horaria y los lectores previstos a partir de la solicitud. Preguntar por el alcance faltante que cambiaría el informe. Para una escritura en Notion, resolver también la página exacta, el encabezado del informe y si el usuario desea un anexado o un reemplazo.
Usar lecturas autorizadas de GitHub expuestas por el entorno actual. Si esas operaciones no están disponibles, informar la capacidad faltante. Nunca inventar IDs de acciones de conectores ni registros recuperados.
## Seleccionar y resumir
- Incluir PR fusionados cuyas marcas de tiempo de fusión caigan dentro de la ventana solicitada. Distinguir los registros cerrados sin fusionar del trabajo fusionado.
- Incluir una instantánea separada de PR abiertos actuales solo si se solicita, etiquetada con la hora de recuperación. No presentar el estado actual como estado histórico.
- Recuperar todas las páginas de resultados dentro del alcance donde sea compatible. Divulgar registros no disponibles, resultados truncados o consultas fallidas; una consulta incompleta no es una consulta con cero resultados.
- Conservar la URL del PR, el número, el título, el autor, el estado y la marca de tiempo relevante. Resumir a partir de la descripción del PR y los cambios disponibles para la herramienta.
- Describir el impacto, el despliegue, los bloqueos y los responsables de la próxima acción solo cuando la evidencia los respalde. No tratar al autor como el responsable de la próxima acción de forma predeterminada.
- Devolver el alcance seleccionado, las secciones del informe, los enlaces de origen y las preguntas sin resolver. Ajustar el nivel de detalle a los lectores previstos.
## Escritura opcional en Notion
Una solicitud de borrador devuelve un borrador. Escribir solo cuando el usuario haya autorizado el destino y la operación concretos; preservar la autorización existente en lugar de exigir confirmación repetida.
Comprobar el encabezado del informe antes de anexar. Si ya existe un informe y no está autorizado el reemplazo, devolver su ubicación y preguntar cómo proceder. Preservar el contenido no relacionado.
Después de una escritura, volver a leer la sección si es compatible y devolver su ubicación. Si el resultado de la escritura es incierto, inspeccionar el destino antes de reintentar. Si la verificación no está disponible, informar esa limitación en lugar de afirmar que la escritura fue confirmada.Descarga el mismo SKILL.md de weekly-pr-report para personalizarlo con los campos de tu equipo.
Tres decisiones del archivo merece la pena conservar:
- Una descripción enfocada: Indica cuándo es útil la Skill. El descubrimiento y la invocación dependen del entorno del agente.
- Reglas de selección explícitas: La hora de merge determina qué PRs pertenecen a la sección de trabajo completado.
- Un alcance de escritura definido: Las instrucciones piden al agente que compruebe el contenido existente y respete la operación solicitada. Guían el comportamiento; los permisos aplican el acceso.
Prueba los casos límite antes de desplegarla
Antes de compartir la Skill con tu equipo, ejecútala contra una semana o un repositorio diferentes y compara su salida con los registros de origen. Prueba estos casos:
| Escenario de prueba | Comportamiento esperado del agente |
|---|---|
| Una semana tranquila con 0 PRs fusionados | Informa de cero tras una consulta completa; no inventa aspectos destacados ni extrae PRs más antiguos. |
| Un PR fusionado 1 minuto fuera de la ventana | Excluido de la sección de fusionados. |
| Un PR cerrado y no fusionado | Excluido del trabajo fusionado. |
| Un PR sin descripción (p. ej. “bump version”) | Resume el cambio sin procesar y señala explícitamente el impacto como no documentado. |
| El encabezado de destino ya existe en Notion | Comprueba la sección existente y sigue la operación autorizada; pregunta cómo proceder si no se autorizó el reemplazo. |
| Repositorio o página inaccesibles | Informa claramente del permiso faltante en lugar de fingir que el repositorio está vacío. |
Si el agente repite una fecha antigua en la segunda ejecución, asegúrate de que el rango de fechas no esté codificado de forma fija en las instrucciones. Si alucina el impacto en el cliente, ajusta la regla de resumen.
Comparte y automatiza con tu equipo
Después de comprobar una segunda ejecución, sigue las instrucciones de instalación de tu paquete de Skill o el mecanismo de importación compatible con el entorno de tu agente. Descargar el archivo por sí solo no lo instala. Consulta Usar Skills con Leina para el flujo de trabajo de directorios.
- Uso interactivo: Los compañeros de equipo pueden invocarla de forma natural en el chat: “@Leina ejecuta weekly-pr-report para backend/api cubriendo del 28 de septiembre al 4 de octubre de 2026, en America/Los_Angeles. Devuelve un borrador aquí.”
- Permisos: Cada compañero de equipo necesita permiso para usar la conexión de GitHub, además de la conexión de Notion cuando guarde un informe. Comprueba esas cuentas en Connections.
- Ejecuciones programadas: Solicita una tarea recurrente con su zona horaria, ventana de informe y ubicación de entrega. Verifica la programación que configura Leina y revisa su primera salida programada. Guardar la Skill no crea una programación.
Comparte el archivo revisado con sus Apps requeridas, un informe de ejemplo y una fecha de versión o revisión. Cuando el equipo cambie las reglas de informe, actualiza ese archivo y comprueba otra ejecución.