1
Escribe una skills de documentación
Empieza creando una skill para la tarea que quieras estandarizar. En este ejemplo, crearemos una skill que genere documentación de API cada vez que un miembro del equipo agregue una etiqueta a un ticket.Ve a Customize > Skills y haz clic en + (New skill). Asígnale el nombre
add-docs.Escribe instrucciones paso a paso concretas. Haz referencia a rutas de archivo y convenciones reales para que Devin siga los estándares de tu equipo:Cuanto más específica sea tu skill, mejores resultados obtendrás. Haz referencia a las plantillas de documentación, guías de estilo y herramientas que tu equipo usa realmente. Consulta Cómo escribir una buena skill para obtener más información.2
Sincronizar la skill con Linear
Conecta tu integración con Linear si aún no lo has hecho: ve a Settings > Connections > Linear y haz clic en Connect. Selecciona los equipos a los que Devin debe tener acceso.Una vez conectada, desplázate hasta Skills y haz clic en Add skill. Selecciona
add-docs en el menú desplegable. Así se crea la etiqueta de la skill en Linear, dentro del grupo de etiquetas Devin Skills; la lista de Skills muestra la etiqueta que debes usar (@skills:add-docs si ninguna otra skill sincronizada tiene ese nombre) junto con un botón para copiarla.A partir de ahora, cuando alguien agregue esa etiqueta a un ticket, Devin iniciará una sesión con tu skill.Para que las etiquetas de skills se sincronicen automáticamente con Linear, tu workspace de Linear debe tener Manage workspace labels configurado en All members (en Settings > Security de Linear). Si no está habilitado, tendrás que crear las etiquetas manualmente en Linear.
3
Etiquetar tickets y generar documentación
Cuando un miembro del equipo agrega la etiqueta
@skills:add-docs a un ticket como este:ENG-215: Add POST /api/v2/webhooks endpoint — accepts a URL and event types, validates the URL is reachable, stores the subscription, and returns the webhook ID.Devin inicia automáticamente una sesión y sigue tu skill de documentación:
- Lee el ticket: obtiene la descripción del endpoint, los parámetros y cualquier PR vinculado
- Localiza el código fuente: encuentra el handler de la ruta, el esquema de validación de la solicitud y los tipos de respuesta
- Genera la documentación: crea una página nueva en
docs/api/con el mismo formato que ya usas - Abre un PR: incluye la nueva página de documentación y la barra lateral actualizada
@skills:add-docs para generar la documentación de varios endpoints en paralelo.4
Crea más skills para tu equipo
El mismo patrón funciona para cualquier tarea recurrente. Crea una skill, sincronízala como etiqueta y tu equipo podrá activarla desde cualquier ticket. Estas son algunas ideas:
@skills:write-tests— Agrega cobertura de pruebas para la funcionalidad descrita en un ticket@skills:refactor— Refactoriza código siguiendo las convenciones de tu equipo@skills:security-audit— Revisa el código en busca de vulnerabilidades de seguridad y abre un PR con las correcciones@skills:migrate— Ejecuta una migración estandarizada (actualización de dependencias, cambio de versión de la API)

