Skills

Slack Agent Skill: montar un agente de Slack en Vercel con eve

Para quien quiera desplegar un agente de Slack en Vercel: instala con el npx skills add vercel-labs/slack-agent-skill oficial, y los eventos de Slack solo se verifican con Connect tras el despliegue.

Official source · slack-agent-skill

Install

npx skills add vercel-labs/slack-agent-skill

Para quién

Esta skill está pensada para quien quiera construir y desplegar un agente de Slack en Vercel. Encaja con eve (el marco de agentes persistentes de Vercel) y Vercel Connect (que aloja las credenciales de Slack). Documentación de eve: https://eve.dev/docs Notas de Connect: https://vercel.com/kb/guide/vercel-connect El repositorio insiste: no tienes que manejar tú mismo el bot token ni el signing secret.

El uso más ajustado: vas a usar /slack-agent para crear un proyecto o configurar uno existente, primero pruebas en local herramientas, instrucciones y conversaciones en la interfaz de texto de eve dev, y dejas los eventos de Slack para después del despliegue. No encaja si quieres guardar tú mismo el signing secret de Slack, o si esperas recorrer todos los eventos en la interfaz de Slack sin desplegar.

No apliques este comando de instalación en un entorno sin soporte de skills. Tampoco trates un túnel ngrok como paso obligatorio: la documentación indica que los eventos de Slack llegan por Connect al proyecto desplegado; no hace falta ngrok.

Primer intento en 3 minutos

El comando oficial de instalación es: npx skills add vercel-labs/slack-agent-skill. La URL del repositorio es https://github.com/vercel-labs/slack-agent-skill Sigue solo esta página. No escribas instaladores no documentados.

Requisitos previos: el asistente actual admite skills y tienes un directorio vacío desechable o un proyecto eve existente. El lugar de instalación es el directorio de skills del asistente. Tras instalar, confirma que ves /slack-agent new, /slack-agent configure, /slack-agent deploy y /slack-agent test.

Primera tarea de bajo riesgo: no despliegues primero. Si partes de cero, ejecuta primero /slack-agent new (monta el andamiaje con eve), pero confirma antes de escribir archivos que el directorio es de práctica. Si ya hay proyecto, usa /slack-agent configure (detecta eve automáticamente). Señal de éxito: el andamiaje o la configuración está lista y aún no has ejecutado /slack-agent deploy.

La verificación local va por la TUI de eve dev: prueba herramientas, instrucciones y conversaciones. Los eventos de la interfaz de Slack esperan al despliegue y llegan al proyecto por Vercel Connect. En las notas de variables de entorno de Slack solo aparece SLACK_CONNECTOR; no inventes otros marcadores de secretos. /slack-agent test sirve para preparar pruebas; espera a que las conversaciones locales funcionen antes de plantearlo.

Casos de uso

Caso 1: andamiaje desde cero. /slack-agent new monta un proyecto nuevo con eve. Encaja cuando aún no tienes repositorio y solo quieres ver en local la estructura del agente. La documentación no lista los archivos generados, así que solo puedes comprobar que «el comando funcionó y apareció un proyecto eve». Confirma el directorio antes de escribir. Página de contraste: https://github.com/vercel-labs/slack-agent-skill

Caso 2: configurar un proyecto existente y separar la verificación local y la de producción. /slack-agent configure detecta eve automáticamente. En local usa eve dev para probar herramientas, instrucciones y conversaciones; los eventos de Slack llegan por Connect tras el despliegue y no hace falta ngrok. /slack-agent deploy despliega a producción y debe ir después de que la TUI local pase. Connect aloja OAuth, la rotación de tokens y la verificación de webhooks; la única variable de entorno de Slack nombrada es SLACK_CONNECTOR. La documentación no describe cómo rellenar esa variable ni el rollback de producción; no despliegues antes de terminar la configuración de Connect.

Límites de uso

Límite de instalación: lo oficial solo escribe npx skills add vercel-labs/slack-agent-skill. Límite de comandos: se pueden comprobar /slack-agent new, configure, deploy, test. Límite de credenciales: no tienes que gestionar tú mismo el bot token ni el signing secret; la única variable de Slack nombrada es SLACK_CONNECTOR. Límite de prueba: la TUI local prueba herramientas, instrucciones y conversaciones; los eventos de Slack se verifican con Connect tras el despliegue y no hace falta ngrok. Límite de marco: eve y Vercel Connect son las dependencias documentadas, con docs en https://eve.dev/docs y https://vercel.com/kb/guide/vercel-connect No se garantiza que otras plataformas de alojamiento se puedan aplicar tal cual.