@sysvv/ai-skill 1.0.0

package/dist/core/frontmatter.js

@@ -0,0 +1,8 @@
+import matter from "gray-matter";
+export function parseSkillFile(content) {
+    const parsed = matter(content);
+    return {
+        metadata: parsed.data,
+        body: parsed.content.trim()
+    };
+}

package/dist/core/registry.js

@@ -0,0 +1,24 @@
+import fs from "fs-extra";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+/** Resolve a pasta skills/ relativa ao pacote, não ao cwd do usuário */
+function getSkillsRoot() {
+    return path.resolve(__dirname, "../../skills");
+}
+export async function findSkillFiles() {
+    const root = getSkillsRoot();
+    const entries = await fs.readdir(root);
+    const results = [];
+    for (const entry of entries) {
+        const full = path.join(root, entry);
+        const stat = await fs.stat(full);
+        if (stat.isDirectory()) {
+            const skillFile = path.join(full, "SKILL.md");
+            if (await fs.pathExists(skillFile)) {
+                results.push(skillFile);
+            }
+        }
+    }
+    return results;
+}

package/dist/core/render.js

@@ -0,0 +1,6 @@
+export function renderTemplate(text, variables = {}) {
+    return text.replace(/\{\{(.*?)\}\}/g, (_, key) => {
+        const cleanKey = String(key).trim();
+        return variables[cleanKey] ?? "";
+    });
+}

package/dist/core/skill.js

@@ -0,0 +1,22 @@
+import fs from "fs-extra";
+import path from "node:path";
+import { parseSkillFile } from "./frontmatter.js";
+import { renderTemplate } from "./render.js";
+export async function loadSkill(skillFilePath, agent) {
+    const absolute = path.resolve(skillFilePath);
+    const content = await fs.readFile(absolute, "utf8");
+    const { metadata, body } = parseSkillFile(content);
+    const baseVariables = metadata.variables ?? {};
+    const agentOverride = metadata.provider_overrides?.[agent] ?? {};
+    const variables = {
+        ...baseVariables,
+        ...Object.fromEntries(Object.entries(agentOverride).map(([key, value]) => [`provider_${key}`, value]))
+    };
+    const renderedBody = renderTemplate(body, variables);
+    return {
+        path: absolute,
+        metadata,
+        rawBody: body,
+        renderedBody
+    };
+}

package/dist/index.js

@@ -0,0 +1,63 @@
+#!/usr/bin/env node
+import inquirer from "inquirer";
+import fs from "fs-extra";
+import path from "node:path";
+import { findSkillFiles } from "./core/registry.js";
+import { parseSkillFile } from "./core/frontmatter.js";
+import { loadSkill } from "./core/skill.js";
+const AGENT_DIRS = {
+    claude: ".claude/skills",
+    codex: ".codex/skills",
+    gemini: ".gemini/skills",
+};
+async function main() {
+    const { agent } = await inquirer.prompt([
+        {
+            type: "list",
+            name: "agent",
+            message: "Qual IA você usa?",
+            choices: Object.keys(AGENT_DIRS)
+        }
+    ]);
+    const skillFiles = await findSkillFiles();
+    const available = [];
+    for (const file of skillFiles) {
+        const content = await fs.readFile(file, "utf8");
+        const { metadata } = parseSkillFile(content);
+        available.push({
+            file,
+            name: metadata.name,
+            title: metadata.title ?? metadata.name,
+            description: metadata.description
+        });
+    }
+    if (available.length === 0) {
+        console.log("Nenhuma skill encontrada.");
+        process.exit(1);
+    }
+    const { selected } = await inquirer.prompt([
+        {
+            type: "checkbox",
+            name: "selected",
+            message: "Escolha as skills que deseja instalar:",
+            choices: available.map((s) => ({
+                name: `${s.title} — ${s.description}`,
+                value: s.file
+            })),
+            validate: (answer) => answer.length > 0 ? true : "Selecione pelo menos uma skill."
+        }
+    ]);
+    const destBase = path.resolve(AGENT_DIRS[agent]);
+    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(`  ✔ ${skill.metadata.name}`);
+    }
+    console.log(`\nSkills instaladas em ${destBase}/\n`);
+}
+main().catch((err) => {
+    console.error("Erro:", err.message);
+    process.exit(1);
+});

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@sysvv/ai-skill",
+  "version": "1.0.0",
+  "description": "Instale skills de IA direto no seu projeto. Escolha o agent, escolha as skills.",
+  "type": "module",
+  "bin": {
+    "ai-skill": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "skills"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/index.ts",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "ai",
+    "skills",
+    "claude",
+    "codex",
+    "gemini",
+    "cli",
+    "prompt"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "fs-extra": "^11.3.0",
+    "gray-matter": "^4.0.3",
+    "inquirer": "^12.5.2"
+  },
+  "devDependencies": {
+    "@types/fs-extra": "^11.0.4",
+    "@types/node": "^22.15.21",
+    "tsx": "^4.19.4",
+    "typescript": "^5.8.3"
+  }
+}

package/skills/create-ticket/SKILL.md

@@ -0,0 +1,30 @@
+---
+name: create-ticket
+title: Create Ticket
+description: criar tickets técnicos claros a partir de contexto solto.
+version: 1.0.0
+providers:
+  - codex
+  - gemini
+  - claude
+variables:
+  language: pt-BR
+provider_overrides:
+  codex:
+    style: "priorizar campos técnicos e objetividade"
+  gemini:
+    style: "priorizar clareza didática"
+  claude:
+    style: "priorizar síntese e bullets"
+---
+
+Transforme a solicitação em ticket com:
+
+- título
+- contexto
+- problema
+- critério de aceite
+- próximos passos
+
+Idioma: {{language}}
+Estilo do provider: {{provider_style}}

package/skills/customer-reply/SKILL.md

@@ -0,0 +1,37 @@
+---
+name: customer-reply
+title: Customer Reply
+description: gerar respostas profissionais para clientes a partir de contexto interno.
+version: 1.0.0
+providers:
+  - codex
+  - gemini
+  - claude
+variables:
+  language: pt-BR
+  tone: profissional
+provider_overrides:
+  codex:
+    style: "tom direto e corporativo"
+  gemini:
+    style: "tom empático e didático"
+  claude:
+    style: "tom claro e conciso"
+---
+
+Você é um assistente especialista em comunicação com clientes.
+
+Objetivo:
+Gerar uma resposta profissional ao cliente com base no contexto interno fornecido.
+
+Formato de saída:
+- Saudação
+- Resposta ao problema
+- Próximos passos
+- Encerramento
+
+Idioma: {{language}}
+Tom: {{tone}}
+
+Instrução específica do provider:
+{{provider_style}}

package/skills/summarize-meeting/SKILL.md

@@ -0,0 +1,39 @@
+---
+name: summarize-meeting
+title: Summarize Meeting
+description: resumir reuniões em formato executivo com decisões, riscos e próximos passos.
+version: 1.0.0
+providers:
+  - codex
+  - gemini
+  - claude
+variables:
+  language: pt-BR
+  tone: executivo
+provider_overrides:
+  codex:
+    style: "retornar estrutura mais operacional e objetiva"
+  gemini:
+    style: "retornar texto mais didático e organizado"
+  claude:
+    style: "retornar bullets curtos e alta clareza"
+output:
+  format: markdown
+---
+
+Você é um assistente especialista em resumir reuniões.
+
+Objetivo:
+Transformar notas, atas ou transcrições em um resumo acionável.
+
+Formato de saída:
+- Resumo executivo
+- Decisões tomadas
+- Riscos
+- Próximos passos
+
+Idioma: {{language}}
+Tom: {{tone}}
+
+Instrução específica do provider:
+{{provider_style}}