@sysvv/ai-skill 1.1.0 → 1.3.0

package/dist/core/mcp.js

@@ -0,0 +1,72 @@
+import fs from "fs-extra";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+/** Onde cada agent espera o arquivo de MCP */
+const MCP_TARGETS = {
+    claude: ".mcp.json",
+    codex: ".codex/mcp.json",
+    gemini: ".gemini/mcp.json",
+    copilot: ".github/copilot/mcp.json",
+};
+/** Resolve o caminho do .mcp.json dentro de /mcps/ */
+function getMcpFilePath(name) {
+    return path.resolve(__dirname, "../../mcps", `${name}.mcp.json`);
+}
+/** Carrega a definição de um MCP pelo nome */
+export async function loadMcp(name) {
+    const mcpFile = getMcpFilePath(name);
+    if (!(await fs.pathExists(mcpFile))) {
+        throw new Error(`MCP "${name}" não encontrado em mcps/${name}.mcp.json`);
+    }
+    return fs.readJson(mcpFile);
+}
+/** Extrai apenas os campos de server config (sem metadata) */
+function extractServerConfig(mcp) {
+    if (mcp.transport === "stdio") {
+        const config = { command: mcp.command };
+        if (mcp.args?.length)
+            config.args = mcp.args;
+        if (mcp.env && Object.keys(mcp.env).length)
+            config.env = mcp.env;
+        return config;
+    }
+    // sse | streamable-http
+    const config = { url: mcp.url };
+    if (mcp.headers && Object.keys(mcp.headers).length)
+        config.headers = mcp.headers;
+    if (mcp.env && Object.keys(mcp.env).length)
+        config.env = mcp.env;
+    return config;
+}
+/** Escreve o MCP no arquivo alvo do agent, fazendo merge com configs existentes */
+export async function writeMcp(agent, mcp) {
+    const targetFile = MCP_TARGETS[agent];
+    if (!targetFile)
+        throw new Error(`Agent "${agent}" não tem target de MCP configurado.`);
+    const targetPath = path.resolve(targetFile);
+    let existing = {};
+    if (await fs.pathExists(targetPath)) {
+        existing = await fs.readJson(targetPath);
+    }
+    const mcpServers = existing.mcpServers ?? {};
+    mcpServers[mcp.name] = extractServerConfig(mcp);
+    await fs.ensureDir(path.dirname(targetPath));
+    await fs.writeJson(targetPath, { ...existing, mcpServers }, { spaces: 2 });
+    return targetPath;
+}
+/** Lista todos os MCPs disponíveis */
+export async function listMcps() {
+    const mcpsDir = path.resolve(__dirname, "../../mcps");
+    if (!(await fs.pathExists(mcpsDir)))
+        return [];
+    const files = await fs.readdir(mcpsDir);
+    const results = [];
+    for (const file of files) {
+        if (file.endsWith(".mcp.json")) {
+            const mcp = await fs.readJson(path.join(mcpsDir, file));
+            results.push(mcp);
+        }
+    }
+    return results;
+}

package/dist/index.js

@@ -7,6 +7,7 @@ import { fileURLToPath } from "node:url";
 import { findSkillFiles } from "./core/registry.js";
 import { parseSkillFile } from "./core/frontmatter.js";
 import { loadSkill } from "./core/skill.js";
+import { loadMcp, writeMcp } from "./core/mcp.js";
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 // ── ANSI ────────────────────────────────────────────────────────────────
 const ANSI = {
@@ -18,18 +19,34 @@ const PINK = '\x1b[38;2;238;54;141m';
 const BLUE = '\x1b[38;2;14;93;171m';
 const RED = '\x1b[38;2;255;70;70m';
 const GREEN = '\x1b[38;2;80;200;120m';
-// ── ASCII Art Letters (5 lines) ─────────────────────────────────────────
+const YELLOW = '\x1b[38;2;255;200;50m';
+const WHITE = '\x1b[97m';
+// ── Inquirer Theme ──────────────────────────────────────────────────────
+const sysTheme = {
+    icon: {
+        cursor: PINK + '❯' + ANSI.reset,
+        checked: PINK + '◉' + ANSI.reset,
+        unchecked: ANSI.dim + '○' + ANSI.reset,
+    },
+    style: {
+        highlight: (text) => PINK + ANSI.bold + text + ANSI.reset,
+        answer: (text) => BLUE + ANSI.bold + text + ANSI.reset,
+        message: (text) => WHITE + ANSI.bold + text + ANSI.reset,
+    },
+    helpMode: 'always',
+};
+// ── ASCII Art Letters (7 lines, bigger) ─────────────────────────────────
 const LETTERS = {
-    A: [' █████ ', '██   ██', '███████', '██   ██', '██   ██'],
-    I: ['██', '██', '██', '██', '██'],
-    K: ['██  ██', '██ ██ ', '████  ', '██ ██ ', '██  ██'],
-    L: ['██     ', '██     ', '██     ', '██     ', '███████'],
-    S: ['███████', '██     ', '███████', '     ██', '███████'],
-    Y: ['██   ██', ' ██ ██ ', '  ███  ', '  ███  ', '  ███  '],
+    A: ['  ██████  ', ' ██    ██ ', '██      ██', '██████████', '██      ██', '██      ██', '██      ██'],
+    I: ['████', ' ██ ', ' ██ ', ' ██ ', ' ██ ', ' ██ ', '████'],
+    K: ['██    ██', '██   ██ ', '██  ██  ', '█████   ', '██  ██  ', '██   ██ ', '██    ██'],
+    L: ['██       ', '██       ', '██       ', '██       ', '██       ', '██       ', '█████████'],
+    S: [' ████████ ', '██        ', '██        ', ' ████████ ', '       ██ ', '       ██ ', ' ████████ '],
+    Y: ['██     ██', ' ██   ██ ', '  ██ ██  ', '   ███   ', '   ███   ', '   ███   ', '   ███   '],
 };
-function joinLetters(keys, gap = ' ') {
+function joinLetters(keys, gap = '  ') {
     const letters = keys.map(k => LETTERS[k]);
-    return Array.from({ length: 5 }, (_, i) => letters.map(l => l[i]).join(gap));
+    return Array.from({ length: 7 }, (_, i) => letters.map(l => l[i]).join(gap));
 }
 function centerPad(line, totalWidth) {
     const spaces = Math.max(0, Math.floor((totalWidth - line.length) / 2));
@@ -46,28 +63,35 @@ function showBanner() {
     const aiLines = joinLetters(['A', 'I']);
     const skillsLines = joinLetters(['S', 'K', 'I', 'L', 'L', 'S']);
     const maxWidth = Math.max(sysLines[0].length, aiLines[0].length, skillsLines[0].length);
-    const indent = '  ';
+    const indent = '   ';
+    const separator = ANSI.dim + indent + centerPad('─'.repeat(maxWidth), maxWidth) + ANSI.reset;
+    console.log('');
     console.log('');
     for (const line of sysLines) {
         console.log(indent + PINK + ANSI.bold + centerPad(line, maxWidth) + ANSI.reset);
     }
     console.log('');
     for (const line of aiLines) {
-        console.log(indent + BLUE + centerPad(line, maxWidth) + ANSI.reset);
+        console.log(indent + BLUE + ANSI.bold + centerPad(line, maxWidth) + ANSI.reset);
     }
+    console.log('');
     for (const line of skillsLines) {
         console.log(indent + BLUE + centerPad(line, maxWidth) + ANSI.reset);
     }
     console.log('');
-    console.log(indent + ANSI.dim + centerPad(`VERSION ${version}`, maxWidth) + ANSI.reset);
+    console.log(separator);
+    console.log('');
+    console.log(indent + WHITE + ANSI.bold + centerPad(`v${version}`, maxWidth) + ANSI.reset);
     console.log('');
     const desc = 'Skills para turbinar seus agentes de codigo';
-    const boxInner = desc.length + 2;
+    const boxInner = desc.length + 4;
     console.log(indent + ANSI.dim + centerPad('┌' + '─'.repeat(boxInner) + '┐', maxWidth) + ANSI.reset);
-    console.log(indent + ANSI.dim + centerPad('│ ' + desc + ' │', maxWidth) + ANSI.reset);
+    console.log(indent + ANSI.dim + centerPad('│  ' + WHITE + desc + ANSI.reset + ANSI.dim + '  │', maxWidth) + ANSI.reset);
     console.log(indent + ANSI.dim + centerPad('└' + '─'.repeat(boxInner) + '┘', maxWidth) + ANSI.reset);
     console.log('');
-    console.log(indent + ANSI.dim + '  ℹ Tip: npx @sysvv/ai-skill --claude | --codex | --gemini | --clear' + ANSI.reset);
+    console.log(indent + ANSI.dim + centerPad('npx @sysvv/ai-skill --claude | --codex | --gemini | --copilot | --clear', maxWidth) + ANSI.reset);
+    console.log('');
+    console.log(separator);
     console.log('');
 }
 // ── Config ──────────────────────────────────────────────────────────────
@@ -75,6 +99,7 @@ const AGENT_DIRS = {
     claude: ".claude/skills",
     codex: ".codex/skills",
     gemini: ".gemini/skills",
+    copilot: ".github/skills",
 };
 // ── Parse args ──────────────────────────────────────────────────────────
 function parseArgs() {
@@ -87,7 +112,7 @@ function parseArgs() {
     }
     return {};
 }
-// ── Install skills for agent ────────────────────────────────────────────
+// ── Install skills + MCPs for agent ─────────────────────────────────────
 async function installSkills(agent) {
     const skillFiles = await findSkillFiles();
     const available = [];
@@ -98,71 +123,113 @@ async function installSkills(agent) {
             file,
             name: metadata.name,
             title: metadata.title ?? metadata.name,
-            description: metadata.description
+            description: metadata.description,
+            mcps: metadata.mcps ?? []
         });
     }
     if (available.length === 0) {
-        console.log("Nenhuma skill encontrada.");
+        console.log("  Nenhuma skill encontrada.");
         process.exit(1);
     }
     const { selected } = await inquirer.prompt([
         {
             type: "checkbox",
             name: "selected",
-            message: "Escolha as skills que deseja instalar:",
+            message: "Escolha as skills:",
             choices: available.map((s) => ({
-                name: `${s.title} — ${s.description}`,
+                name: `${s.title} ${ANSI.dim}— ${s.description}${s.mcps.length > 0 ? ` ${YELLOW}[MCP]${ANSI.reset}${ANSI.dim}` : ''}${ANSI.reset}`,
                 value: s.file
             })),
-            validate: (answer) => answer.length > 0 ? true : "Selecione pelo menos uma skill."
+            validate: (answer) => answer.length > 0 ? true : "Selecione pelo menos uma skill.",
+            theme: sysTheme
         }
     ]);
     const destBase = path.resolve(AGENT_DIRS[agent]);
+    const mcpsToInstall = new Set();
+    // Instala skills
+    console.log('');
     for (const file of selected) {
         const skill = await loadSkill(file, agent);
         const skillDir = path.join(destBase, skill.metadata.name);
         await fs.ensureDir(skillDir);
         await fs.writeFile(path.join(skillDir, "SKILL.md"), skill.renderedBody, "utf8");
         console.log(`  ${GREEN}✔${ANSI.reset} ${skill.metadata.name}`);
+        // Coleta MCPs necessários
+        for (const mcpName of skill.metadata.mcps ?? []) {
+            mcpsToInstall.add(mcpName);
+        }
+    }
+    // Instala MCPs automaticamente
+    if (mcpsToInstall.size > 0) {
+        console.log('');
+        let mcpTarget = '';
+        for (const mcpName of mcpsToInstall) {
+            try {
+                const mcp = await loadMcp(mcpName);
+                mcpTarget = await writeMcp(agent, mcp);
+                console.log(`  ${GREEN}✔${ANSI.reset} MCP ${ANSI.bold}${mcpName}${ANSI.reset} ${ANSI.dim}→ ${mcpTarget}${ANSI.reset}`);
+            }
+            catch (err) {
+                console.log(`  ${RED}✖${ANSI.reset} MCP ${mcpName}: ${err.message}`);
+            }
+        }
     }
     console.log(`\n  Skills instaladas em ${ANSI.bold}${destBase}/${ANSI.reset}\n`);
 }
-// ── Clear all skills ────────────────────────────────────────────────────
+// ── Clear all skills + MCPs ─────────────────────────────────────────────
 async function clearSkills() {
-    const existing = [];
+    const MCP_TARGETS = {
+        claude: ".mcp.json",
+        codex: ".codex/mcp.json",
+        gemini: ".gemini/mcp.json",
+        copilot: ".github/copilot/mcp.json",
+    };
+    const found = [];
     for (const [agent, dir] of Object.entries(AGENT_DIRS)) {
-        const full = path.resolve(dir);
-        if (await fs.pathExists(full)) {
-            existing.push(agent);
+        const skillsFull = path.resolve(dir);
+        const mcpFull = path.resolve(MCP_TARGETS[agent]);
+        const hasSkills = await fs.pathExists(skillsFull);
+        const hasMcp = await fs.pathExists(mcpFull);
+        if (hasSkills || hasMcp) {
+            found.push({ agent, skillsDir: skillsFull, mcpFile: mcpFull, hasSkills, hasMcp });
         }
     }
-    if (existing.length === 0) {
-        console.log("  Nenhuma pasta de skills encontrada.\n");
+    if (found.length === 0) {
+        console.log("  Nenhuma pasta de skills ou MCP encontrada.\n");
         return;
     }
-    console.log(`  ${RED}⚠${ANSI.reset}  Pastas encontradas:\n`);
-    for (const agent of existing) {
-        console.log(`     ${ANSI.dim}${path.resolve(AGENT_DIRS[agent])}${ANSI.reset}`);
+    console.log(`  ${RED}⚠${ANSI.reset}  Encontrado:\n`);
+    for (const f of found) {
+        if (f.hasSkills)
+            console.log(`     ${ANSI.dim}${f.skillsDir}${ANSI.reset}`);
+        if (f.hasMcp)
+            console.log(`     ${ANSI.dim}${f.mcpFile}${ANSI.reset}`);
     }
     console.log('');
     const { confirm } = await inquirer.prompt([
         {
             type: "confirm",
             name: "confirm",
-            message: "Tem certeza que deseja apagar TODAS as pastas de skills?",
-            default: false
+            message: "Tem certeza que deseja apagar TUDO (skills + MCPs)?",
+            default: false,
+            theme: sysTheme
         }
     ]);
     if (!confirm) {
         console.log("\n  Operação cancelada.\n");
         return;
     }
-    for (const agent of existing) {
-        const full = path.resolve(AGENT_DIRS[agent]);
-        await fs.remove(full);
-        console.log(`  ${RED}✖${ANSI.reset} ${full} removida`);
+    for (const f of found) {
+        if (f.hasSkills) {
+            await fs.remove(f.skillsDir);
+            console.log(`  ${RED}✖${ANSI.reset} ${f.skillsDir}`);
+        }
+        if (f.hasMcp) {
+            await fs.remove(f.mcpFile);
+            console.log(`  ${RED}✖${ANSI.reset} ${f.mcpFile}`);
+        }
     }
-    console.log("\n  Todas as skills foram removidas.\n");
+    console.log("\n  Tudo removido.\n");
 }
 // ── Main ────────────────────────────────────────────────────────────────
 async function main() {
@@ -176,13 +243,16 @@ async function main() {
         await installSkills(agent);
         return;
     }
-    // Modo interativo
     const { chosenAgent } = await inquirer.prompt([
         {
             type: "list",
             name: "chosenAgent",
             message: "Qual IA você usa?",
-            choices: Object.keys(AGENT_DIRS)
+            choices: Object.keys(AGENT_DIRS).map((key) => ({
+                name: `${ANSI.bold}${key.charAt(0).toUpperCase() + key.slice(1)}${ANSI.reset}`,
+                value: key
+            })),
+            theme: sysTheme
         }
     ]);
     await installSkills(chosenAgent);

package/mcps/azure-devops.mcp.json

@@ -0,0 +1,16 @@
+{
+  "$schema": "../schemas/mcp.schema.json",
+  "name": "azure-devops",
+  "description": "Integração com Azure DevOps para work items, repos e pipelines.",
+  "transport": "stdio",
+  "command": "npx",
+  "args": [
+    "-y",
+    "@azure-devops/mcp",
+    "sysmanagerdevops",
+    "-d", "core", "work", "work-items"
+  ],
+  "env": {
+    "AZURE_DEVOPS_PAT": "${AZURE_DEVOPS_PAT}"
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sysvv/ai-skill",
-  "version": "1.1.0",
+  "version": "1.3.0",
   "description": "Instale skills de IA direto no seu projeto. Escolha o agent, escolha as skills.",
   "type": "module",
   "bin": {
@@ -8,7 +8,9 @@
   },
   "files": [
     "dist",
-    "skills"
+    "skills",
+    "mcps",
+    "schemas"
   ],
   "scripts": {
     "build": "tsc",

package/schemas/mcp.schema.json

@@ -0,0 +1,93 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://sysvv.dev/schemas/mcp.schema.json",
+  "title": "MCP Server Configuration",
+  "description": "Schema para configuração de servidores MCP (Model Context Protocol). Suporta os transportes stdio, sse e streamable-http.",
+  "type": "object",
+  "properties": {
+    "$schema": {
+      "type": "string",
+      "description": "Referência ao JSON Schema para validação e autocomplete."
+    },
+    "name": {
+      "type": "string",
+      "pattern": "^[a-z0-9][a-z0-9-]*$",
+      "description": "Identificador único do MCP. Deve ser slug (lowercase, hífens). Ex: azure-devops"
+    },
+    "description": {
+      "type": "string",
+      "description": "Descrição curta do que o MCP faz."
+    },
+    "transport": {
+      "type": "string",
+      "enum": ["stdio", "sse", "streamable-http"],
+      "description": "Tipo de transporte do MCP."
+    },
+    "command": {
+      "type": "string",
+      "description": "[stdio] Comando para iniciar o servidor MCP."
+    },
+    "args": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "[stdio] Argumentos passados ao comando."
+    },
+    "url": {
+      "type": "string",
+      "format": "uri",
+      "description": "[sse | streamable-http] URL do servidor MCP."
+    },
+    "headers": {
+      "type": "object",
+      "additionalProperties": { "type": "string" },
+      "description": "[sse | streamable-http] Headers HTTP enviados nas requisições."
+    },
+    "env": {
+      "type": "object",
+      "additionalProperties": { "type": "string" },
+      "description": "Variáveis de ambiente. Use ${VAR} para referências dinâmicas."
+    }
+  },
+  "required": ["name", "description", "transport"],
+  "allOf": [
+    {
+      "if": {
+        "properties": { "transport": { "const": "stdio" } },
+        "required": ["transport"]
+      },
+      "then": {
+        "required": ["command"],
+        "properties": {
+          "url": false,
+          "headers": false
+        }
+      }
+    },
+    {
+      "if": {
+        "properties": { "transport": { "const": "sse" } },
+        "required": ["transport"]
+      },
+      "then": {
+        "required": ["url"],
+        "properties": {
+          "command": false,
+          "args": false
+        }
+      }
+    },
+    {
+      "if": {
+        "properties": { "transport": { "const": "streamable-http" } },
+        "required": ["transport"]
+      },
+      "then": {
+        "required": ["url"],
+        "properties": {
+          "command": false,
+          "args": false
+        }
+      }
+    }
+  ]
+}

package/skills/azure-devops/SKILL.md

@@ -0,0 +1,37 @@
+---
+name: azure-devops
+title: Azure DevOps
+description: gerenciar work items, repos e pipelines no Azure DevOps.
+version: 1.0.0
+providers:
+  - claude
+  - codex
+  - gemini
+mcps:
+  - azure-devops
+variables:
+  language: pt-BR
+provider_overrides:
+  claude:
+    style: "retornar bullets curtos e objetivos"
+  codex:
+    style: "retornar estrutura operacional"
+  gemini:
+    style: "retornar texto claro e organizado"
+---
+
+Você é um assistente especialista em Azure DevOps.
+
+Objetivo:
+Ajudar a gerenciar work items, repositórios e pipelines usando a integração com Azure DevOps.
+
+Capacidades:
+- Criar e atualizar work items
+- Consultar status de pipelines
+- Listar repositórios e branches
+- Buscar PRs e reviews
+
+Idioma: {{language}}
+
+Instrução específica do provider:
+{{provider_style}}