Plugins e Skills

Plugins

O Que Sao Plugins?

Plugins sao modulos TypeScript que estendem a funcionalidade do Neotask em tempo de execucao. Eles podem adicionar novos canais de mensagens, ferramentas de agente, metodos RPC, comandos CLI, servicos em segundo plano e skills.

Plugins Oficiais

Canais de Mensagens:

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

Recursos:

• Voice Call -- Suporte a telefonia SIP para chamadas de voz de entrada/saida
• Memory (LanceDB) -- Memoria de longo prazo com busca por similaridade vetorial
• MCP Native -- Integracao de servidor Model Context Protocol para ponte com ferramentas externas

Provedores de Auth:

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

Capacidades de Plugins

Plugins podem registrar:

• Metodos RPC -- Metodos WebSocket personalizados para clientes chamarem
• Handlers HTTP -- Endpoints HTTP personalizados no Gateway
• Ferramentas de Agente -- Novas ferramentas com schemas tipados que agentes podem invocar
• Comandos CLI -- Comandos adicionais de linha de comando
• Servicos em Segundo Plano -- Processos de longa execucao gerenciados pelo Gateway
• Skills -- Diretorios de skills empacotados com o plugin
• Comandos de Auto-Resposta -- Comandos que executam sem envolvimento do agente de IA

Seguranca de Plugins

O Neotask verifica os plugins em varias camadas antes que eles rodem:

• Assinados e verificados. Os pacotes do catalogo publico do Construct sao publicados pelo Neotask, inspecionados automaticamente antes do lancamento e assinados com a chave de lancamento do Neotask. Antes de instalar um pacote, o Neotask confere a assinatura com chaves embutidas no Neotask e verifica o hash SHA-256 do download.
• Sem scripts de instalacao. Os pacotes do Construct ja trazem suas dependencias, entao a instalacao nunca roda um gerenciador de pacotes nem um script de instalacao. Quando outra instalacao de plugin usa o npm, os scripts de instalacao ficam desativados.
• Verificacao na instalacao. Plugins instalados fora do Construct passam por uma verificacao de codigo perigoso, e achados criticos bloqueiam a instalacao.
• Licenca por versao. Um plugin do Construct so carrega enquanto sua conta tiver uma permissao valida para aquela versao. Versoes revogadas nao carregam.
• Aprovacoes para acoes do agente. As chamadas de ferramentas do agente, incluindo ferramentas adicionadas por plugins, sao verificadas pela sua politica de aprovacao, e as acoes que precisam do seu aval esperam por ele. Um software que o agente queira instalar fora das receitas de instalacao incluidas no Neotask sempre mostra o comando exato e espera sua aprovacao.
• Sandbox opcional. Voce pode rodar as ferramentas de um agente em um container Docker isolado, em vez de diretamente no seu computador. O sandbox vem desativado por padrao; veja Seguranca para ativa-lo.

Plugins nativos rodam dentro do processo do Gateway, entao um plugin instalado fora do Construct e um codigo que voce escolhe rodar. Use plugins.allow para listar os plugins que podem carregar.

Skills

O Que Sao Skills?

Skills sao capacidades modulares que ensinam novos workflows aos agentes. Cada skill e um arquivo markdown (SKILL.md) com instrucoes que sao injetadas no contexto do agente quando relevantes.

Locais de Skills (Ordem de Prioridade)

1. Skills do workspace -- <workspace>/skills/ (prioridade mais alta)
2. Skills gerenciadas -- ~/.neotask/skills/
3. Skills empacotadas -- Distribuidas com o Neotask
4. Skills de plugins -- Skills empacotadas com plugins instalados
5. Diretorios extras -- Caminhos adicionais configurados (prioridade mais baixa)

Quando multiplas skills compartilham o mesmo nome, o local de maior prioridade vence.

Recursos de Skills

• Invocavel pelo usuario -- Acione skills diretamente com comandos de barra (ex.: /docker-build)
• Invocavel pelo modelo -- Skills que o agente pode invocar por conta propria quando relevante
• Despacho de comando -- Skills que mapeiam para ferramentas especificas
• Gating de requisitos -- Skills so carregam quando seus requisitos sao atendidos (binarios necessarios, chaves de configuracao, variaveis de ambiente, plugins)

Criando Skills

Crie um arquivo SKILL.md com frontmatter YAML definindo os metadados e instrucoes da skill:

Campos do frontmatter:

• name -- Identificador da skill
• description -- O que a skill faz
• homepage -- Link para documentacao
• user-invocable -- Se usuarios podem aciona-la diretamente
• disable-model-invocation -- Impede o agente de invoca-la autonomamente
• command-dispatch -- Ferramenta para despachar
• metadata.neotask.requires -- Pre-requisitos (bins, config, env, plugins)

Corpo: Instrucoes em Markdown que ensinam o agente como usar a skill, incluindo exemplos e diretrizes.

Catalogo de Skills

Navegue pelas skills disponiveis no catalogo de skills.

Categorias de Skills

Skills cobrem uma ampla gama de capacidades: