Plugins y Skills

Plugins

Que Son los Plugins?

Los plugins son modulos TypeScript que extienden la funcionalidad de Neotask en tiempo de ejecucion. Pueden agregar nuevos canales de mensajeria, herramientas de agente, metodos RPC, comandos CLI, servicios en segundo plano y skills.

Plugins Oficiales

Canales de Mensajeria:

• Microsoft Teams, Matrix, Nostr, Zalo, Feishu/Lark, LINE, Nextcloud Talk, Mattermost, Tlon, Twitch

Caracteristicas:

• Voice Call -- Soporte de telefonia SIP para llamadas de voz entrantes/salientes
• Memory (LanceDB) -- Memoria a largo plazo con busqueda de similitud vectorial
• MCP Native -- Integracion de servidor Model Context Protocol para conectar herramientas externas

Proveedores de Autenticacion:

• Google Antigravity OAuth, Gemini CLI OAuth, Qwen OAuth, Minimax OAuth, VS Code Copilot Proxy

Capacidades de Plugins

Los plugins pueden registrar:

• Metodos RPC -- Metodos WebSocket personalizados para que los clientes llamen
• Handlers HTTP -- Endpoints HTTP personalizados en el Gateway
• Herramientas de Agente -- Nuevas herramientas con esquemas tipados que los agentes pueden invocar
• Comandos CLI -- Comandos adicionales de linea de comandos
• Servicios en Segundo Plano -- Procesos de larga ejecucion gestionados por el Gateway
• Skills -- Directorios de skills empaquetados con el plugin
• Comandos de Auto-Respuesta -- Comandos que se ejecutan sin involucramiento del agente de IA

Seguridad de Plugins

Neotask revisa los plugins en varias capas antes de que se ejecuten:

• Firmados y verificados. Los paquetes del catálogo público de Construct los publica Neotask, se inspeccionan automáticamente antes de publicarse y se firman con la clave de publicación de Neotask. Antes de instalar uno, Neotask comprueba la firma con claves integradas en Neotask y verifica el hash SHA-256 de la descarga.
• Sin scripts de instalación. Los paquetes de Construct incluyen sus dependencias, así que instalarlos nunca ejecuta un gestor de paquetes ni un script de instalación. Cuando otra instalación de plugin usa npm, los scripts de instalación están desactivados.
• Análisis al instalar. Los plugins instalados fuera de Construct se analizan en busca de código peligroso, y los hallazgos críticos bloquean la instalación.
• Licencia por versión. Un plugin de Construct solo se carga mientras su cuenta tenga un permiso vigente para esa versión. Las versiones revocadas no se cargan.
• Aprobaciones para las acciones del agente. Las llamadas a herramientas del agente, incluidas las que añaden los plugins, se comprueban con su política de aprobación, y las acciones que requieren su visto bueno lo esperan. El software que un agente quiera instalar fuera de las recetas de instalación incluidas en Neotask siempre le muestra el comando exacto y espera su aprobación.
• Sandbox opcional. Puede ejecutar las herramientas de un agente en un contenedor Docker aislado en lugar de directamente en su equipo. El sandbox está desactivado de forma predeterminada; consulte Seguridad para activarlo.

Los plugins nativos se ejecutan dentro del proceso del Gateway, por lo que un plugin instalado fuera de Construct es código que usted decide ejecutar. Use plugins.allow para indicar qué plugins pueden cargarse.

Skills

Que Son los Skills?

Los skills son capacidades modulares que ensenan a los agentes nuevos flujos de trabajo. Cada skill es un archivo markdown (SKILL.md) con instrucciones que se inyectan en el contexto del agente cuando son relevantes.

Ubicaciones de Skills (Orden de Prioridad)

1. Skills de espacio de trabajo -- <workspace>/skills/ (maxima prioridad)
2. Skills gestionados -- ~/.neotask/skills/
3. Skills incluidos -- Enviados con Neotask
4. Skills de plugins -- Skills empaquetados con plugins instalados
5. Directorios adicionales -- Rutas configuradas adicionales (menor prioridad)

Cuando multiples skills comparten el mismo nombre, la ubicacion de mayor prioridad gana.

Caracteristicas de Skills

• Invocable por usuario -- Activar skills directamente con comandos slash (por ejemplo, /docker-build)
• Invocable por modelo -- Skills que el agente puede invocar por su cuenta cuando son relevantes
• Despacho de comandos -- Skills que se mapean a herramientas especificas
• Filtrado por requisitos -- Los skills solo se cargan cuando sus requisitos se cumplen (binarios requeridos, claves de configuracion, variables de entorno, plugins)

Creando Skills

Cree un archivo SKILL.md con frontmatter YAML definiendo los metadatos e instrucciones del skill:

Campos del frontmatter:

• name -- Identificador del skill
• description -- Lo que hace el skill
• homepage -- Enlace a la documentacion
• user-invocable -- Si los usuarios pueden activarlo directamente
• disable-model-invocation -- Evitar que el agente lo invoque autonomamente
• command-dispatch -- Herramienta a la que despachar
• metadata.neotask.requires -- Prerequisitos (bins, config, env, plugins)

Cuerpo: Instrucciones en Markdown que ensenan al agente como usar el skill, incluyendo ejemplos y pautas.

Catalogo de Skills

Explore los skills disponibles en el catalogo de skills.

Categorias de Skills

Los skills cubren una amplia gama de capacidades: