Nexus Skills

Resumo técnico

Plugin do NEXUS para administrar skills globais do servidor, integradas à CLI skills e disponíveis aos agentes. O backend lista instalações em diferentes estruturas do filesystem, pesquisa o catálogo e executa instalação, remoção e leitura segura de SKILL.md; a interface oferece catálogo, documentação renderizada e geração de Master Prompt.

Escopo executado

• plugin.json — v1.0.0, categoria IA & Machine Learning, is_core: false, ícone lucide zap (sparkles) com icon_bg #fdf4ff, icon.svg próprio e style: design.css.
• Registros: registerTab("nexus-skills","Skills","zap",tab.php), registerDoc("nexus-skills","Sistema de Skills","package",doc.md) e registerJs("nexus-skills","/plugins/nexus-skills/assets/skills-v2.js").
• 9 actions de API (plugin.php, via PluginManager::registerApiAction) — singulares skill_info|skill_search|skill_install|skill_remove + plurais skills_list|skills_search|skills_install|skills_remove|skills_info (5 funções únicas no backend).
• Listagem: skills_list_installed() — 3 caminhos em /opt/agents/skills (raiz, skills/ links, .agents/skills), dedupe por nome (estrutura mais nova vence), versão de package.json seguindo symlinks, scope global, sort alfabético.
• Busca: skills_search() — npx -y skills find <q> --json; parse JSON (results) com fallback regex owner/repo@skill + N installs após limpeza ANSI (preg_replace).
• Instalação: skills_install() — npx -y skills add -y <repo> com cwd /opt/agents/skills; sucesso por strings de saída ou presença no FS.
• Remoção: skills_remove() — npx -y skills remove <name>; sucesso por strings de saída.
• Info/Doc: skills_get_info() — lê SKILL.md (basename sanitizado), skills_parse_metadata() (frontmatter YAML → name/description/version) e skills_get_custom_examples() (Master Prompt automático em inglês com deliverables P0/P1).
• Segurança: execução sempre via nx_secure_exec (sem shell), PATH restrito /opt/node/bin, HOME controlado, nome sanitizado com basename.
• UI Alpine.js (tab.php, 415 linhas, "SKILL MATRIX v4.1"): stats (Total/Ativas/GLOBAL), toolbar premium, grid com skeleton/empty-state, modal Explorar Catálogo e modal Documentação (Markdown + Master Prompt multi-idioma).

Stack e ferramentas

• PHP 8 (sem framework) — backend via nx_secure_exec
• CLI skills (Node.js via npx, bin em /opt/node/bin) — find/add/remove
• Alpine.js + Tailwind CSS (tab.php) + marked (render Markdown no frontend) + assets/skills-v2.js
• Filesystem /opt/agents/skills (raiz + skills/ + .agents/skills) — sem banco de dados

Tags operacionais

• Skills
• CLI npx
• Master Prompt
• SKILL.md
• Agentes IA
• Plugin NEXUS

Resultado operacional

• Skills globais plug-and-play: instalar/remover capacidades dos agentes direto do painel NEXUS, sem tocar no servidor.
• 3 caminhos de descoberta em /opt/agents/skills (raiz, links simbólicos e .agents/skills) com dedupe inteligente — coexistem skills antigas e da nova CLI.
• Busca no registro oficial via npx skills find com parse robusto (JSON + fallback regex/ANSI) e exibição de downloads/autor.
• Master Prompt automático por skill — template de elite specialist gerado do frontmatter real (description/name), com sufixo de idioma selecionável no modal de doc.
• Documentação integrada: SKILL.md renderizado como Markdown (via marked), sem frontmatter, com chips de metadados.
• Segurança: todas as execuções via nx_secure_exec com PATH/HOME restritos e sanitização de caminhos.