Cómo crear skills en Devin

Las skills en Devin son archivos con convenciones, reglas y buenas prácticas que le enseñan a un agente de IA cómo ejecutar tareas específicas de tu proyecto sin repetir instrucciones. Si trabajas con Next.js y quieres que tu agente entienda tu flujo de trabajo, aquí verás cómo crearlas y encontrarlas.

La idea central es simple: en lugar de escribir comandos manuales una y otra vez, escribes una skill una sola vez y queda disponible para cualquier sesión. Esto le permite a Devin decidir con contexto qué hacer, hablando en lenguaje natural en vez de memorizar comandos.

Cómo funciona una skill personalizada para correr el servidor

Una skill vive dentro de la carpeta .devin, en el folder skills, y ahí creas una carpeta con el nombre de la skill. En el ejemplo se llama runServer y el archivo principal es skill.md [00:58].

Lo interesante es lo que fuerza a hacer: cuando le pides correr el proyecto, Devin no adivina qué ambiente usar. Como solo hay un frontend, siempre lo ejecuta, pero puede conectarse al entorno local o al de producción según elijas [02:23].

La skill define pasos concretos:

• Preguntar con la herramienta askUserQuestion en qué entorno debe correr el backend, local o producción.
• Si eliges local, verificar que Supabase local esté activo antes de levantar Next, y ofrecer correr npm run supabase:start si no responde.
• Correr el script correspondiente en background y esperar a que termine.
• Reportar la URL real donde quedó escuchando, sin asumir el puerto.

Ese último punto importa: Next.js recomienda por defecto el puerto 3000, pero como suele estar ocupado, se enruta al 3001 u otro libre. Por eso la instrucción es leer el puerto de salida, no asumirlo [04:12].

¿Qué es una skill en un agente de IA como Devin? Es un archivo de instrucciones, reglas y procesos que le indica al agente cómo ejecutar una tarea específica de tu proyecto. Se guarda en tu editor y queda disponible para todas tus sesiones sin repetir el contexto.

Por qué usar dotenv-cli en vez de un shell script

Un detalle técnico clave: los perfiles se seleccionan con dotenv-cli, un paquete instalado que aparece en el package.json. La razón es evitar crear un archivo .sh, que exigiría habilidades técnicas distintas [05:42].

El objetivo real es poder hablar en lenguaje natural con el agente. Así, next dev autocarga el entorno local, pero process.env definido por dotenv -e tiene prioridad, por lo que dev:prod sí apunta a producción. Esto explica por qué, aunque creas estar en local, al iniciar sesión puedes ver datos de producción [06:20].

Lo mismo aplica a los builds: npm run build usa datos locales y build:prod usa los de producción.

Qué diferencia hay entre correr en producción y en local

Al probar la skill en la terminal, basta con decir "corre el servidor del proyecto" y Devin pregunta qué backend quieres. Nunca escribes el comando a mano; lo hablas [08:09].

En producción, ejecuta npm run dev:prod, genera una URL de preview y levanta el frontend en el puerto 3001. Al entrar a localhost:3001, el proyecto detecta la sesión guardada y muestra los datos de producción [09:29].

En local, la historia cambia. Al pedir el entorno local, Devin intenta correr npm run dev, pero avisa que la instancia de Supabase local no responde porque Docker no está corriendo [12:07].

Ahí ocurre lo valioso: el agente inicia Docker por sí mismo, ejecuta npm run supabase:start, espera a que el log aparezca en verde y luego levanta Next.js [13:10]. Como usa Supabase local, incluso te da un servidor de correo para recibir los magic links. El resultado es un proyecto sin entradas, porque esa es la data local, completamente distinta a la de producción [14:26].

Dónde buscar skills ya escritas para tu proyecto

No todo hay que escribirlo desde cero. Vercel, la empresa detrás de Next.js, creó skills.sh, un repositorio con muchas skills gratuitas para usar en tu proyecto [15:20].

Es el ecosistema abierto de skills para todo tipo de agentes. Al momento de grabar el curso había 1,344,229 skills disponibles, y muestra métricas útiles como cuáles tuvieron más instalaciones en las últimas 24 horas, con una que alcanzó 22,500 instalaciones [16:12].

¿Qué es skills.sh? Es un catálogo abierto creado por Vercel donde encuentras skills gratuitas de frameworks como Next.js para instalar en tu agente. Puedes copiarlas con un comando o pegar un prompt directamente en tu terminal.

Buscando "frontend" aparecen ejemplos de compañías como Anthropic, con skills de frontend design. Cada una trae dos formas de instalarse: un comando directo o un prompt que copias y ejecutas en tu agente [17:30].

Cómo instala Devin una skill de un repositorio remoto

Al pegar el prompt en la terminal, Devin ejecuta npx skills use con el enlace a la skill de Anthropic [18:42]. Antes de actuar, avisa que revisará el código porque proviene de un repositorio remoto, un buen recordatorio de seguridad [19:35].

La skill de frontend design resultó tener solo dos archivos: skill.md y license.txt. No es un script que se ejecuta solo, sino una guía de diseño que requiere un brief y confirmación antes de diseñar [20:20].

Devin analiza el proyecto y detecta que ShipLog es una app de Next.js 16 con Tailwind y componentes de shadcn, usando pantallas de proyecto, inputs y un timeline [21:15]. Luego pide definir la dirección de diseño y el público objetivo.

Con las respuestas genera un plan completo con tema, audiencia, colores, tipografía y layout, cada decisión con su contenido para ejecutarla [23:40].

Por qué guardar el plan en un archivo Markdown separado

En lugar de escribir el código de inmediato, se le pide guardar todo el plan en un archivo Markdown para ejecutarlo después. Como ya existía un plan.md, Devin crea uno nuevo llamado design-plan.md [25:10].

Esto importa: no reemplaza ni modifica el archivo existente, crea uno separado porque el plan de diseño no tiene relación con el otro. Podrías tener un plan de features, de testing, de deployments o de contenido, cada uno independiente [25:48].

El archivo queda listo en la raíz de ShipLog con ocho pasos en orden y el archivo real que corresponde a cada uno [26:40]. Así tienes la mejora de diseño lista para ejecutar cuando la necesites.

La gran ventaja es que Devin mejora sin que escribas un prompt larguísimo varias veces. Le das una skill una sola vez y queda en tu proyecto para cualquier sesión. Solo asegúrate de subirla a tu repositorio, porque si queda solo en tu máquina, ese conocimiento no viaja con el proyecto.

¿Qué skill usaste en tus proyectos y para qué la aplicas? Cuéntame en los comentarios.