@hasna/skills 0.1.7 → 0.1.8

package/bin/index.js

@@ -1878,7 +1878,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@hasna/skills",
-    version: "0.1.7",
+    version: "0.1.8",
     description: "Skills library for AI coding agents",
     type: "module",
     bin: {
@@ -34782,6 +34782,9 @@ var init_stdio2 = __esm(() => {
 
 // src/mcp/index.ts
 var exports_mcp = {};
+import { existsSync as existsSync3, readdirSync as readdirSync3, statSync as statSync2 } from "fs";
+import { join as join3 } from "path";
+import { homedir as homedir2 } from "os";
 async function main() {
   const transport = new StdioServerTransport;
   await server.connect(transport);
@@ -34883,6 +34886,52 @@ var init_mcp2 = __esm(() => {
       isError: !result.success
     };
   });
+  server.registerTool("install_category", {
+    title: "Install Category",
+    description: "Install all skills in a category. Optionally install for a specific agent (claude, codex, gemini, or all) with a given scope.",
+    inputSchema: {
+      category: exports_external.string().describe("Category name (case-insensitive, e.g. 'Event Management')"),
+      for: exports_external.string().optional().describe("Agent target: claude, codex, gemini, or all"),
+      scope: exports_external.string().optional().describe("Install scope: global or project (default: global)")
+    }
+  }, async ({ category, for: agentArg, scope }) => {
+    const matchedCategory = CATEGORIES.find((c) => c.toLowerCase() === category.toLowerCase());
+    if (!matchedCategory) {
+      return {
+        content: [{ type: "text", text: `Unknown category: ${category}. Available: ${CATEGORIES.join(", ")}` }],
+        isError: true
+      };
+    }
+    const categorySkills = getSkillsByCategory(matchedCategory);
+    const names = categorySkills.map((s) => s.name);
+    if (agentArg) {
+      let agents;
+      try {
+        agents = resolveAgents(agentArg);
+      } catch (err) {
+        return {
+          content: [{ type: "text", text: err.message }],
+          isError: true
+        };
+      }
+      const results2 = [];
+      for (const name of names) {
+        for (const a of agents) {
+          const r = installSkillForAgent(name, { agent: a, scope: scope || "global" }, generateSkillMd);
+          results2.push({ ...r, agent: a, scope: scope || "global" });
+        }
+      }
+      return {
+        content: [{ type: "text", text: JSON.stringify({ category: matchedCategory, count: names.length, results: results2 }, null, 2) }],
+        isError: results2.some((r) => !r.success)
+      };
+    }
+    const results = names.map((name) => installSkill(name));
+    return {
+      content: [{ type: "text", text: JSON.stringify({ category: matchedCategory, count: names.length, results }, null, 2) }],
+      isError: results.some((r) => !r.success)
+    };
+  });
   server.registerTool("remove_skill", {
     title: "Remove Skill",
     description: "Remove an installed skill. Without --for, removes from .skills/. With --for, removes from agent skill directory.",
@@ -34975,6 +35024,94 @@ var init_mcp2 = __esm(() => {
       content: [{ type: "text", text: JSON.stringify({ exitCode: result.exitCode, skill: name }, null, 2) }]
     };
   });
+  server.registerTool("export_skills", {
+    title: "Export Skills",
+    description: "Export the list of currently installed skills as a JSON payload that can be imported elsewhere"
+  }, async () => {
+    const skills = getInstalledSkills();
+    const payload = {
+      version: 1,
+      skills,
+      timestamp: new Date().toISOString()
+    };
+    return { content: [{ type: "text", text: JSON.stringify(payload, null, 2) }] };
+  });
+  server.registerTool("import_skills", {
+    title: "Import Skills",
+    description: "Install a list of skills from an export payload. Supports agent-specific installs via the 'for' parameter.",
+    inputSchema: {
+      skills: exports_external.array(exports_external.string()).describe("List of skill names to install"),
+      for: exports_external.string().optional().describe("Agent target: claude, codex, gemini, or all"),
+      scope: exports_external.string().optional().describe("Install scope: global or project (default: global)")
+    }
+  }, async ({ skills: skillList, for: agentArg, scope }) => {
+    if (!skillList || skillList.length === 0) {
+      return { content: [{ type: "text", text: JSON.stringify({ imported: 0, results: [] }, null, 2) }] };
+    }
+    const results = [];
+    if (agentArg) {
+      let agents;
+      try {
+        agents = resolveAgents(agentArg);
+      } catch (err) {
+        return {
+          content: [{ type: "text", text: err.message }],
+          isError: true
+        };
+      }
+      for (const name of skillList) {
+        const agentResults = agents.map((a) => installSkillForAgent(name, { agent: a, scope: scope || "global" }, generateSkillMd));
+        const success2 = agentResults.every((r) => r.success);
+        const errors4 = agentResults.filter((r) => !r.success).map((r) => r.error).filter(Boolean);
+        results.push({ skill: name, success: success2, ...errors4.length > 0 ? { error: errors4.join("; ") } : {} });
+      }
+    } else {
+      for (const name of skillList) {
+        const result = installSkill(name);
+        results.push({ skill: result.skill, success: result.success, ...result.error ? { error: result.error } : {} });
+      }
+    }
+    const imported = results.filter((r) => r.success).length;
+    const hasErrors = results.some((r) => !r.success);
+    return {
+      content: [{ type: "text", text: JSON.stringify({ imported, total: skillList.length, results }, null, 2) }],
+      isError: hasErrors
+    };
+  });
+  server.registerTool("whoami", {
+    title: "Skills Whoami",
+    description: "Show setup summary: package version, installed skills, agent configurations, skills directory location, and working directory"
+  }, async () => {
+    const version2 = package_default.version;
+    const cwd = process.cwd();
+    const installed = getInstalledSkills();
+    const agentNames = ["claude", "codex", "gemini"];
+    const agents = [];
+    for (const agent of agentNames) {
+      const agentSkillsPath = join3(homedir2(), `.${agent}`, "skills");
+      const exists = existsSync3(agentSkillsPath);
+      let skillCount = 0;
+      if (exists) {
+        try {
+          skillCount = readdirSync3(agentSkillsPath).filter((f) => {
+            const full = join3(agentSkillsPath, f);
+            return f.startsWith("skill-") && statSync2(full).isDirectory();
+          }).length;
+        } catch {}
+      }
+      agents.push({ agent, path: agentSkillsPath, exists, skillCount });
+    }
+    const skillsDir = getSkillPath("image").replace(/[/\\][^/\\]*$/, "");
+    const result = {
+      version: version2,
+      installedCount: installed.length,
+      installed,
+      agents,
+      skillsDir,
+      cwd
+    };
+    return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+  });
   server.registerResource("Skills Registry", "skills://registry", {
     description: "Full list of all available skills as JSON"
   }, async () => ({
@@ -35010,15 +35147,15 @@ __export(exports_serve, {
   startServer: () => startServer,
   createFetchHandler: () => createFetchHandler
 });
-import { existsSync as existsSync3, readFileSync as readFileSync3 } from "fs";
-import { join as join3, dirname as dirname2, extname } from "path";
+import { existsSync as existsSync4, readFileSync as readFileSync3 } from "fs";
+import { join as join4, dirname as dirname2, extname } from "path";
 import { fileURLToPath as fileURLToPath2 } from "url";
 function getPackageJson() {
   try {
     const scriptDir = dirname2(fileURLToPath2(import.meta.url));
     for (const rel of ["../..", ".."]) {
-      const pkgPath = join3(scriptDir, rel, "package.json");
-      if (existsSync3(pkgPath)) {
+      const pkgPath = join4(scriptDir, rel, "package.json");
+      if (existsSync4(pkgPath)) {
         const pkg = JSON.parse(readFileSync3(pkgPath, "utf-8"));
         return { version: pkg.version || "unknown", name: pkg.name || "skills" };
       }
@@ -35030,20 +35167,20 @@ function resolveDashboardDir() {
   const candidates = [];
   try {
     const scriptDir = dirname2(fileURLToPath2(import.meta.url));
-    candidates.push(join3(scriptDir, "..", "dashboard", "dist"));
-    candidates.push(join3(scriptDir, "..", "..", "dashboard", "dist"));
+    candidates.push(join4(scriptDir, "..", "dashboard", "dist"));
+    candidates.push(join4(scriptDir, "..", "..", "dashboard", "dist"));
   } catch {}
   if (process.argv[1]) {
     const mainDir = dirname2(process.argv[1]);
-    candidates.push(join3(mainDir, "..", "dashboard", "dist"));
-    candidates.push(join3(mainDir, "..", "..", "dashboard", "dist"));
+    candidates.push(join4(mainDir, "..", "dashboard", "dist"));
+    candidates.push(join4(mainDir, "..", "..", "dashboard", "dist"));
   }
-  candidates.push(join3(process.cwd(), "dashboard", "dist"));
+  candidates.push(join4(process.cwd(), "dashboard", "dist"));
   for (const candidate of candidates) {
-    if (existsSync3(candidate))
+    if (existsSync4(candidate))
       return candidate;
   }
-  return join3(process.cwd(), "dashboard", "dist");
+  return join4(process.cwd(), "dashboard", "dist");
 }
 function json2(data, status = 200) {
   return new Response(JSON.stringify(data), {
@@ -35077,7 +35214,7 @@ function getAllSkillsWithStatus() {
   });
 }
 function serveStaticFile(filePath) {
-  if (!existsSync3(filePath))
+  if (!existsSync4(filePath))
     return null;
   const ext = extname(filePath);
   const contentType = MIME_TYPES[ext] || "application/octet-stream";
@@ -35087,7 +35224,7 @@ function serveStaticFile(filePath) {
 }
 function createFetchHandler(options) {
   const dashboardDir = options?.dashboardDir ?? resolveDashboardDir();
-  const dashboardExists = options?.dashboardExists ?? existsSync3(dashboardDir);
+  const dashboardExists = options?.dashboardExists ?? existsSync4(dashboardDir);
   return async function fetchHandler(req) {
     const url2 = new URL(req.url);
     const path = url2.pathname;
@@ -35201,6 +35338,43 @@ function createFetchHandler(options) {
         return json2(result, result.success ? 200 : 400);
       }
     }
+    if (path === "/api/skills/install-category" && method === "POST") {
+      let body = {};
+      try {
+        const text = await req.text();
+        if (text)
+          body = JSON.parse(text);
+      } catch {}
+      if (!body.category) {
+        return json2({ error: "Missing required field: category" }, 400);
+      }
+      const matchedCategory = CATEGORIES.find((c) => c.toLowerCase() === body.category.toLowerCase());
+      if (!matchedCategory) {
+        return json2({ error: `Unknown category: ${body.category}. Available: ${CATEGORIES.join(", ")}` }, 400);
+      }
+      const categorySkills = getSkillsByCategory(matchedCategory);
+      const names = categorySkills.map((s) => s.name);
+      if (body.for) {
+        try {
+          const agents = resolveAgents(body.for);
+          const scope = body.scope === "project" ? "project" : "global";
+          const results = [];
+          for (const name of names) {
+            for (const agent of agents) {
+              results.push(installSkillForAgent(name, { agent, scope }, generateSkillMd));
+            }
+          }
+          const allSuccess = results.every((r) => r.success);
+          return json2({ category: matchedCategory, count: names.length, success: allSuccess, results }, allSuccess ? 200 : 207);
+        } catch (e) {
+          return json2({ success: false, error: e instanceof Error ? e.message : "Unknown error" }, 400);
+        }
+      } else {
+        const results = names.map((name) => installSkill(name));
+        const allSuccess = results.every((r) => r.success);
+        return json2({ category: matchedCategory, count: names.length, success: allSuccess, results }, allSuccess ? 200 : 207);
+      }
+    }
     const removeMatch = path.match(/^\/api\/skills\/([^/]+)\/remove$/);
     if (removeMatch && method === "POST") {
       const name = removeMatch[1];
@@ -35213,6 +35387,50 @@ function createFetchHandler(options) {
       const pkg = getPackageJson();
       return json2({ version: pkg.version, name: pkg.name });
     }
+    if (path === "/api/export" && method === "GET") {
+      const skills = getInstalledSkills();
+      return json2({
+        version: 1,
+        skills,
+        timestamp: new Date().toISOString()
+      });
+    }
+    if (path === "/api/import" && method === "POST") {
+      let body = {};
+      try {
+        const text = await req.text();
+        if (text)
+          body = JSON.parse(text);
+      } catch {
+        return json2({ error: "Invalid JSON body" }, 400);
+      }
+      if (!Array.isArray(body.skills)) {
+        return json2({ error: 'Body must include "skills" array' }, 400);
+      }
+      const skillList = body.skills;
+      const results = [];
+      if (body.for) {
+        try {
+          const agents = resolveAgents(body.for);
+          const scope = body.scope === "project" ? "project" : "global";
+          for (const name of skillList) {
+            const agentResults = agents.map((agent) => installSkillForAgent(name, { agent, scope }, generateSkillMd));
+            const success2 = agentResults.every((r) => r.success);
+            const errors4 = agentResults.filter((r) => !r.success).map((r) => r.error).filter(Boolean);
+            results.push({ skill: name, success: success2, ...errors4.length > 0 ? { error: errors4.join("; ") } : {} });
+          }
+        } catch (e) {
+          return json2({ error: e instanceof Error ? e.message : "Unknown error" }, 400);
+        }
+      } else {
+        for (const name of skillList) {
+          const result = installSkill(name);
+          results.push({ skill: result.skill, success: result.success, ...result.error ? { error: result.error } : {} });
+        }
+      }
+      const imported = results.filter((r) => r.success).length;
+      return json2({ imported, total: skillList.length, results }, imported === skillList.length ? 200 : 207);
+    }
     if (path === "/api/self-update" && method === "POST") {
       try {
         const pkg = getPackageJson();
@@ -35242,12 +35460,12 @@ function createFetchHandler(options) {
     }
     if (dashboardExists && (method === "GET" || method === "HEAD")) {
       if (path !== "/") {
-        const filePath = join3(dashboardDir, path);
+        const filePath = join4(dashboardDir, path);
         const res2 = serveStaticFile(filePath);
         if (res2)
           return res2;
       }
-      const indexPath = join3(dashboardDir, "index.html");
+      const indexPath = join4(dashboardDir, "index.html");
       const res = serveStaticFile(indexPath);
       if (res)
         return res;
@@ -35258,7 +35476,7 @@ function createFetchHandler(options) {
 async function startServer(port = 0, options) {
   const shouldOpen = options?.open ?? true;
   const dashboardDir = resolveDashboardDir();
-  const dashboardExists = existsSync3(dashboardDir);
+  const dashboardExists = existsSync4(dashboardDir);
   if (!dashboardExists) {
     console.error(`
 Dashboard not found at: ${dashboardDir}`);
@@ -35338,8 +35556,8 @@ var {
 // src/cli/index.tsx
 init_package();
 import chalk2 from "chalk";
-import { existsSync as existsSync4, writeFileSync as writeFileSync2, appendFileSync, readFileSync as readFileSync4, readdirSync as readdirSync3, statSync as statSync2 } from "fs";
-import { join as join4 } from "path";
+import { existsSync as existsSync5, writeFileSync as writeFileSync2, appendFileSync, readFileSync as readFileSync4, readdirSync as readdirSync4, statSync as statSync3 } from "fs";
+import { join as join5 } from "path";
 
 // src/cli/components/App.tsx
 import { useState as useState7 } from "react";
@@ -36474,7 +36692,28 @@ program2.command("interactive", { isDefault: true }).alias("i").description("Int
   }
   render(/* @__PURE__ */ jsxDEV7(App, {}, undefined, false, undefined, this));
 });
-program2.command("install").alias("add").argument("<skills...>", "Skills to install").option("-o, --overwrite", "Overwrite existing skills", false).option("--json", "Output results as JSON", false).option("--for <agent>", "Install for agent: claude, codex, gemini, or all").option("--scope <scope>", "Install scope: global or project", "global").option("--dry-run", "Print what would happen without actually installing", false).description("Install one or more skills").action((skills, options) => {
+program2.command("install").alias("add").argument("[skills...]", "Skills to install").option("-o, --overwrite", "Overwrite existing skills", false).option("--json", "Output results as JSON", false).option("--for <agent>", "Install for agent: claude, codex, gemini, or all").option("--scope <scope>", "Install scope: global or project", "global").option("--dry-run", "Print what would happen without actually installing", false).option("--category <category>", "Install all skills in a category (case-insensitive)").description("Install one or more skills").action((skills, options) => {
+  if (skills.length === 0 && !options.category) {
+    console.error("error: missing required argument 'skills' or --category option");
+    process.exitCode = 1;
+    return;
+  }
+  if (options.category) {
+    const matchedCategory = CATEGORIES.find((c) => c.toLowerCase() === options.category.toLowerCase());
+    if (!matchedCategory) {
+      console.error(`Unknown category: ${options.category}`);
+      console.error(`Available: ${CATEGORIES.join(", ")}`);
+      process.exitCode = 1;
+      return;
+    }
+    const categorySkills = getSkillsByCategory(matchedCategory);
+    skills = categorySkills.map((s) => s.name);
+    if (!options.json) {
+      console.log(chalk2.bold(`
+Installing ${skills.length} skills from "${matchedCategory}"...
+`));
+    }
+  }
   const results = [];
   if (options.for) {
     let agents;
@@ -36561,7 +36800,8 @@ Skills installed to .skills/`));
     process.exitCode = 1;
   }
 });
-program2.command("list").alias("ls").option("-c, --category <category>", "Filter by category").option("-i, --installed", "Show only installed skills", false).option("-t, --tags <tags>", "Filter by comma-separated tags (OR logic, case-insensitive)").option("--json", "Output as JSON", false).description("List available or installed skills").action((options) => {
+program2.command("list").alias("ls").option("-c, --category <category>", "Filter by category").option("-i, --installed", "Show only installed skills", false).option("-t, --tags <tags>", "Filter by comma-separated tags (OR logic, case-insensitive)").option("--json", "Output as JSON", false).option("--brief", "One line per skill: name \u2014 description [category]", false).description("List available or installed skills").action((options) => {
+  const brief = options.brief && !options.json;
   if (options.installed) {
     const installed = getInstalledSkills();
     if (options.json) {
@@ -36572,6 +36812,12 @@ program2.command("list").alias("ls").option("-c, --category <category>", "Filter
       console.log(chalk2.dim("No skills installed"));
       return;
     }
+    if (brief) {
+      for (const name of installed) {
+        console.log(name);
+      }
+      return;
+    }
     console.log(chalk2.bold(`
 Installed skills (${installed.length}):
 `));
@@ -36597,6 +36843,12 @@ Installed skills (${installed.length}):
       console.log(JSON.stringify(skills, null, 2));
       return;
     }
+    if (brief) {
+      for (const s of skills) {
+        console.log(`${s.name} \u2014 ${s.description} [${s.category}]`);
+      }
+      return;
+    }
     console.log(chalk2.bold(`
 ${category} (${skills.length}):
 `));
@@ -36611,6 +36863,12 @@ ${category} (${skills.length}):
       console.log(JSON.stringify(skills, null, 2));
       return;
     }
+    if (brief) {
+      for (const s of skills) {
+        console.log(`${s.name} \u2014 ${s.description} [${s.category}]`);
+      }
+      return;
+    }
     console.log(chalk2.bold(`
 Skills matching tags [${tagFilter.join(", ")}] (${skills.length}):
 `));
@@ -36623,6 +36881,16 @@ Skills matching tags [${tagFilter.join(", ")}] (${skills.length}):
     console.log(JSON.stringify(SKILLS, null, 2));
     return;
   }
+  if (brief) {
+    const sorted = [...SKILLS].sort((a, b) => {
+      const catCmp = a.category.localeCompare(b.category);
+      return catCmp !== 0 ? catCmp : a.name.localeCompare(b.name);
+    });
+    for (const s of sorted) {
+      console.log(`${s.name} \u2014 ${s.description} [${s.category}]`);
+    }
+    return;
+  }
   console.log(chalk2.bold(`
 Available skills (${SKILLS.length}):
 `));
@@ -36635,7 +36903,7 @@ Available skills (${SKILLS.length}):
     console.log();
   }
 });
-program2.command("search").argument("<query>", "Search term").option("--json", "Output as JSON", false).option("-c, --category <category>", "Filter results by category").option("-t, --tags <tags>", "Filter results by comma-separated tags (OR logic, case-insensitive)").description("Search for skills").action((query, options) => {
+program2.command("search").argument("<query>", "Search term").option("--json", "Output as JSON", false).option("--brief", "One line per skill: name \u2014 description [category]", false).option("-c, --category <category>", "Filter results by category").option("-t, --tags <tags>", "Filter results by comma-separated tags (OR logic, case-insensitive)").description("Search for skills").action((query, options) => {
   let results = searchSkills(query);
   if (options.category) {
     const category = CATEGORIES.find((c) => c.toLowerCase() === options.category.toLowerCase());
@@ -36651,6 +36919,7 @@ program2.command("search").argument("<query>", "Search term").option("--json", "
     const tagFilter = options.tags.split(",").map((t) => t.trim().toLowerCase()).filter(Boolean);
     results = results.filter((s) => s.tags.some((tag) => tagFilter.includes(tag.toLowerCase())));
   }
+  const brief = options.brief && !options.json;
   if (options.json) {
     console.log(JSON.stringify(results, null, 2));
     return;
@@ -36659,6 +36928,12 @@ program2.command("search").argument("<query>", "Search term").option("--json", "
     console.log(chalk2.dim(`No skills found for "${query}"`));
     return;
   }
+  if (brief) {
+    for (const s of results) {
+      console.log(`${s.name} \u2014 ${s.description} [${s.category}]`);
+    }
+    return;
+  }
   console.log(chalk2.bold(`
 Found ${results.length} skill(s):
 `));
@@ -36667,7 +36942,7 @@ Found ${results.length} skill(s):
     console.log(`    ${s.description}`);
   }
 });
-program2.command("info").argument("<skill>", "Skill name").option("--json", "Output as JSON", false).description("Show details about a specific skill").action((name, options) => {
+program2.command("info").argument("<skill>", "Skill name").option("--json", "Output as JSON", false).option("--brief", "Single line: name \u2014 description [category] (tags: ...)", false).description("Show details about a specific skill").action((name, options) => {
   const skill = getSkill(name);
   if (!skill) {
     console.error(`Skill '${name}' not found`);
@@ -36679,6 +36954,10 @@ program2.command("info").argument("<skill>", "Skill name").option("--json", "Out
     console.log(JSON.stringify({ ...skill, ...reqs }, null, 2));
     return;
   }
+  if (options.brief) {
+    console.log(`${skill.name} \u2014 ${skill.description} [${skill.category}] (tags: ${skill.tags.join(", ")})`);
+    return;
+  }
   console.log(`
 ${chalk2.bold(skill.displayName)}`);
   console.log(`${skill.description}`);
@@ -36909,7 +37188,7 @@ Installing recommended skills for ${options.for} (${options.scope})...
     const envContent = lines.join(`
 `) + `
 `;
-    const envPath = join4(cwd, ".env.example");
+    const envPath = join5(cwd, ".env.example");
     writeFileSync2(envPath, envContent);
     envVarCount = envMap.size;
     if (!options.json) {
@@ -36920,10 +37199,10 @@ Installing recommended skills for ${options.for} (${options.scope})...
       console.log(chalk2.dim("  No environment variables detected across installed skills"));
     }
   }
-  const gitignorePath = join4(cwd, ".gitignore");
+  const gitignorePath = join5(cwd, ".gitignore");
   const gitignoreEntry = ".skills/";
   let gitignoreContent = "";
-  if (existsSync4(gitignorePath)) {
+  if (existsSync5(gitignorePath)) {
     gitignoreContent = readFileSync4(gitignorePath, "utf-8");
   }
   let gitignoreUpdated = false;
@@ -37033,12 +37312,12 @@ program2.command("update").argument("[skills...]", "Skills to update (default: a
   }
   function collectFiles(dir, base = "") {
     const files = new Set;
-    if (!existsSync4(dir))
+    if (!existsSync5(dir))
       return files;
-    for (const entry of readdirSync3(dir)) {
-      const full = join4(dir, entry);
+    for (const entry of readdirSync4(dir)) {
+      const full = join5(dir, entry);
       const rel = base ? `${base}/${entry}` : entry;
-      if (statSync2(full).isDirectory()) {
+      if (statSync3(full).isDirectory()) {
         for (const f of collectFiles(full, rel))
           files.add(f);
       } else {
@@ -37050,7 +37329,7 @@ program2.command("update").argument("[skills...]", "Skills to update (default: a
   const updateResults = [];
   for (const name of toUpdate) {
     const skillName = normalizeSkillName(name);
-    const destPath = join4(process.cwd(), ".skills", skillName);
+    const destPath = join5(process.cwd(), ".skills", skillName);
     const beforeFiles = collectFiles(destPath);
     const result = installSkill(name, { overwrite: true });
     const afterFiles = collectFiles(destPath);
@@ -37131,7 +37410,7 @@ Tags:
 program2.command("mcp").option("--register <agent>", "Register MCP server with agent: claude, codex, gemini, or all").description("Start MCP server (stdio) or register with an agent").action(async (options) => {
   if (options.register) {
     const agents = options.register === "all" ? ["claude", "codex", "gemini"] : [options.register];
-    const binPath = join4(import.meta.dir, "..", "mcp", "index.ts");
+    const binPath = join5(import.meta.dir, "..", "mcp", "index.ts");
     for (const agent of agents) {
       if (agent === "claude") {
         try {
@@ -37145,8 +37424,8 @@ program2.command("mcp").option("--register <agent>", "Register MCP server with a
           console.log(chalk2.yellow(`Manual registration: claude mcp add skills -- bun run ${binPath}`));
         }
       } else if (agent === "codex") {
-        const { homedir: homedir2 } = await import("os");
-        const configPath = join4(homedir2(), ".codex", "config.toml");
+        const { homedir: homedir3 } = await import("os");
+        const configPath = join5(homedir3(), ".codex", "config.toml");
         console.log(chalk2.bold(`
 Add to ${configPath}:`));
         console.log(chalk2.dim(`[mcp_servers.skills]
@@ -37154,8 +37433,8 @@ command = "bun"
 args = ["run", "${binPath}"]`));
         console.log(chalk2.green(`\u2713 Codex MCP config shown above`));
       } else if (agent === "gemini") {
-        const { homedir: homedir2 } = await import("os");
-        const configPath = join4(homedir2(), ".gemini", "settings.json");
+        const { homedir: homedir3 } = await import("os");
+        const configPath = join5(homedir3(), ".gemini", "settings.json");
         console.log(chalk2.bold(`
 Add to ${configPath} mcpServers:`));
         console.log(chalk2.dim(JSON.stringify({
@@ -37216,7 +37495,8 @@ program2.command("completion").argument("<shell>", "Shell type: bash, zsh, or fi
     "self-update",
     "completion",
     "outdated",
-    "doctor"
+    "doctor",
+    "auth"
   ];
   const skillNames = SKILLS.map((s) => s.name);
   const categoryNames = CATEGORIES.map((c) => c);
@@ -37339,6 +37619,117 @@ _skills "$@"
       process.exitCode = 1;
   }
 });
+program2.command("export").option("--json", "Output as JSON (default behavior)", false).description("Export installed skills to JSON for sharing or backup").action((_options) => {
+  const skills = getInstalledSkills();
+  const payload = {
+    version: 1,
+    skills,
+    timestamp: new Date().toISOString()
+  };
+  console.log(JSON.stringify(payload, null, 2));
+});
+program2.command("import").argument("<file>", "JSON file to import (use - for stdin)").option("--json", "Output results as JSON", false).option("--for <agent>", "Install for agent: claude, codex, gemini, or all").option("--scope <scope>", "Install scope: global or project", "global").option("--dry-run", "Show what would be installed without actually installing", false).description("Import and install skills from a JSON export file").action(async (file2, options) => {
+  let raw;
+  try {
+    if (file2 === "-") {
+      raw = await new Response(process.stdin).text();
+    } else {
+      if (!existsSync5(file2)) {
+        console.error(chalk2.red(`File not found: ${file2}`));
+        process.exitCode = 1;
+        return;
+      }
+      raw = readFileSync4(file2, "utf-8");
+    }
+  } catch (err) {
+    console.error(chalk2.red(`Failed to read file: ${err.message}`));
+    process.exitCode = 1;
+    return;
+  }
+  let payload;
+  try {
+    payload = JSON.parse(raw);
+  } catch {
+    console.error(chalk2.red("Invalid JSON in import file"));
+    process.exitCode = 1;
+    return;
+  }
+  if (!payload || typeof payload !== "object" || !Array.isArray(payload.skills)) {
+    console.error(chalk2.red('Invalid format: expected { "version": 1, "skills": [...] }'));
+    process.exitCode = 1;
+    return;
+  }
+  const skillList = payload.skills;
+  const total = skillList.length;
+  if (total === 0) {
+    if (options.json) {
+      console.log(JSON.stringify({ imported: 0, results: [] }));
+    } else {
+      console.log(chalk2.dim("No skills to import"));
+    }
+    return;
+  }
+  if (options.dryRun) {
+    if (options.json) {
+      console.log(JSON.stringify({ dryRun: true, skills: skillList }));
+    } else {
+      console.log(chalk2.bold(`
+[dry-run] Would install ${total} skill(s):
+`));
+      for (let i = 0;i < total; i++) {
+        const target = options.for ? ` for ${options.for} (${options.scope})` : " to .skills/";
+        console.log(chalk2.dim(`  [${i + 1}/${total}] ${skillList[i]}${target}`));
+      }
+    }
+    return;
+  }
+  const results = [];
+  if (options.for) {
+    let agents;
+    try {
+      agents = resolveAgents(options.for);
+    } catch (err) {
+      console.error(chalk2.red(err.message));
+      process.exitCode = 1;
+      return;
+    }
+    for (let i = 0;i < total; i++) {
+      const name = skillList[i];
+      if (!options.json) {
+        process.stdout.write(`[${i + 1}/${total}] Installing ${name}...`);
+      }
+      const agentResults = agents.map((agent) => installSkillForAgent(name, { agent, scope: options.scope }, generateSkillMd));
+      const success2 = agentResults.every((r) => r.success);
+      results.push({ skill: name, success: success2, agentResults });
+      if (!options.json) {
+        console.log(success2 ? " done" : " failed");
+      }
+    }
+  } else {
+    for (let i = 0;i < total; i++) {
+      const name = skillList[i];
+      if (!options.json) {
+        process.stdout.write(`[${i + 1}/${total}] Installing ${name}...`);
+      }
+      const result = installSkill(name);
+      results.push(result);
+      if (!options.json) {
+        console.log(result.success ? " done" : " failed");
+      }
+    }
+  }
+  if (options.json) {
+    console.log(JSON.stringify({ imported: results.filter((r) => r.success).length, total, results }));
+  } else {
+    const succeeded = results.filter((r) => r.success).length;
+    const failed = total - succeeded;
+    console.log(chalk2.bold(`
+Imported ${succeeded}/${total} skill(s)${failed > 0 ? ` (${failed} failed)` : ""}`));
+  }
+  if (results.some((r) => !r.success)) {
+    process.exitCode = 1;
+  }
+});
 program2.command("doctor").option("--json", "Output as JSON", false).description("Check environment variables for installed skills").action((options) => {
   const installed = getInstalledSkills();
   if (installed.length === 0) {
@@ -37377,6 +37768,247 @@ Skills Doctor (${installed.length} installed):
     }
   }
 });
+program2.command("auth").argument("[skill]", "Skill name (omit to check all installed skills)").option("--set <assignment>", "Set an env var in .env file (format: KEY=VALUE)").option("--json", "Output as JSON", false).description("Show auth/env var status for a skill or all installed skills").action((name, options) => {
+  const cwd = process.cwd();
+  const envFilePath = join5(cwd, ".env");
+  if (options.set) {
+    const eqIdx = options.set.indexOf("=");
+    if (eqIdx === -1) {
+      console.error(chalk2.red(`Invalid format for --set. Expected KEY=VALUE, got: ${options.set}`));
+      process.exitCode = 1;
+      return;
+    }
+    const key = options.set.slice(0, eqIdx).trim();
+    const value = options.set.slice(eqIdx + 1);
+    if (!key) {
+      console.error(chalk2.red("Key cannot be empty"));
+      process.exitCode = 1;
+      return;
+    }
+    let existing = "";
+    if (existsSync5(envFilePath)) {
+      existing = readFileSync4(envFilePath, "utf-8");
+    }
+    const keyPattern = new RegExp(`^${key}=.*$`, "m");
+    let updated;
+    if (keyPattern.test(existing)) {
+      updated = existing.replace(keyPattern, `${key}=${value}`);
+    } else {
+      updated = existing.endsWith(`
+`) || existing === "" ? existing + `${key}=${value}
+` : existing + `
+${key}=${value}
+`;
+    }
+    writeFileSync2(envFilePath, updated, "utf-8");
+    console.log(chalk2.green(`Set ${key} in ${envFilePath}`));
+    return;
+  }
+  if (name) {
+    const reqs = getSkillRequirements(name);
+    if (!reqs) {
+      console.error(`Skill '${name}' not found`);
+      process.exitCode = 1;
+      return;
+    }
+    const envVars = reqs.envVars.map((v) => ({ name: v, set: !!process.env[v] }));
+    if (options.json) {
+      console.log(JSON.stringify({ skill: name, envVars }, null, 2));
+      return;
+    }
+    console.log(chalk2.bold(`
+Auth status for ${name}:
+`));
+    if (envVars.length === 0) {
+      console.log(chalk2.dim("  No environment variables required"));
+    } else {
+      for (const v of envVars) {
+        const icon = v.set ? chalk2.green("\u2713") : chalk2.red("\u2717");
+        const status = v.set ? chalk2.green("set") : chalk2.red("missing");
+        console.log(`  ${icon} ${v.name} (${status})`);
+      }
+    }
+    return;
+  }
+  const installed = getInstalledSkills();
+  if (installed.length === 0) {
+    if (options.json) {
+      console.log(JSON.stringify([]));
+    } else {
+      console.log("No skills installed");
+    }
+    return;
+  }
+  const report = [];
+  for (const skillName of installed) {
+    const reqs = getSkillRequirements(skillName);
+    const envVars = (reqs?.envVars ?? []).map((v) => ({ name: v, set: !!process.env[v] }));
+    report.push({ skill: skillName, envVars });
+  }
+  if (options.json) {
+    console.log(JSON.stringify(report, null, 2));
+    return;
+  }
+  console.log(chalk2.bold(`
+Auth status (${installed.length} installed skills):
+`));
+  for (const entry of report) {
+    console.log(chalk2.bold(`  ${entry.skill}`));
+    if (entry.envVars.length === 0) {
+      console.log(chalk2.dim("    No environment variables required"));
+    } else {
+      for (const v of entry.envVars) {
+        const icon = v.set ? chalk2.green("\u2713") : chalk2.red("\u2717");
+        const status = v.set ? chalk2.green("set") : chalk2.red("missing");
+        console.log(`    ${icon} ${v.name} (${status})`);
+      }
+    }
+  }
+});
+program2.command("whoami").option("--json", "Output as JSON", false).description("Show setup summary: version, installed skills, agent configs, and paths").action((options) => {
+  const { homedir: homedir3 } = __require("os");
+  const version2 = package_default.version;
+  const cwd = process.cwd();
+  const installed = getInstalledSkills();
+  const agentNames = ["claude", "codex", "gemini"];
+  const agentConfigs = [];
+  for (const agent of agentNames) {
+    const agentSkillsPath = join5(homedir3(), `.${agent}`, "skills");
+    const exists = existsSync5(agentSkillsPath);
+    let skillCount = 0;
+    if (exists) {
+      try {
+        skillCount = readdirSync4(agentSkillsPath).filter((f) => {
+          const full = join5(agentSkillsPath, f);
+          return f.startsWith("skill-") && statSync3(full).isDirectory();
+        }).length;
+      } catch {}
+    }
+    agentConfigs.push({ agent, path: agentSkillsPath, exists, skillCount });
+  }
+  const skillsDir = getSkillPath("image").replace(/[/\\][^/\\]*$/, "");
+  if (options.json) {
+    console.log(JSON.stringify({
+      version: version2,
+      installedCount: installed.length,
+      installed,
+      agents: agentConfigs,
+      skillsDir,
+      cwd
+    }, null, 2));
+    return;
+  }
+  console.log(chalk2.bold(`
+skills v${version2}
+`));
+  console.log(`${chalk2.dim("Working directory:")} ${cwd}`);
+  console.log(`${chalk2.dim("Skills directory:")}  ${skillsDir}`);
+  console.log();
+  if (installed.length === 0) {
+    console.log(chalk2.dim("No skills installed in current project"));
+  } else {
+    console.log(chalk2.bold(`Installed skills (${installed.length}):`));
+    for (const name of installed) {
+      console.log(`  ${chalk2.cyan(name)}`);
+    }
+  }
+  console.log();
+  console.log(chalk2.bold("Agent configurations:"));
+  for (const cfg of agentConfigs) {
+    if (cfg.exists) {
+      console.log(`  ${chalk2.green("\u2713")} ${cfg.agent} \u2014 ${cfg.skillCount} skill(s) at ${cfg.path}`);
+    } else {
+      console.log(`  ${chalk2.dim("\u2717")} ${cfg.agent} \u2014 not configured`);
+    }
+  }
+});
+program2.command("test").argument("[skill]", "Skill name to test (omit to test all installed skills)").option("--json", "Output results as JSON", false).description("Test skill readiness: env vars, system deps, and npm deps").action(async (skillArg, options) => {
+  let skillNames;
+  if (skillArg) {
+    const registryName = skillArg.startsWith("skill-") ? skillArg.replace("skill-", "") : skillArg;
+    const skill = getSkill(registryName);
+    if (!skill) {
+      if (options.json) {
+        console.log(JSON.stringify({ error: `Skill '${skillArg}' not found` }));
+      } else {
+        console.error(chalk2.red(`Skill '${skillArg}' not found`));
+      }
+      process.exitCode = 1;
+      return;
+    }
+    skillNames = [registryName];
+  } else {
+    skillNames = getInstalledSkills();
+    if (skillNames.length === 0) {
+      if (options.json) {
+        console.log(JSON.stringify([]));
+      } else {
+        console.log(chalk2.dim("No skills installed. Run: skills install <name>"));
+      }
+      return;
+    }
+  }
+  const results = [];
+  for (const name of skillNames) {
+    const reqs = getSkillRequirements(name);
+    const envVars = (reqs?.envVars ?? []).map((v) => ({
+      name: v,
+      set: !!process.env[v]
+    }));
+    const systemDeps = (reqs?.systemDeps ?? []).map((dep) => {
+      const proc = Bun.spawnSync(["which", dep]);
+      return { name: dep, available: proc.exitCode === 0 };
+    });
+    const npmDeps = Object.entries(reqs?.dependencies ?? {}).map(([pkgName, version2]) => ({
+      name: pkgName,
+      version: version2
+    }));
+    const ready = envVars.every((v) => v.set) && systemDeps.every((d) => d.available);
+    results.push({ skill: name, envVars, systemDeps, npmDeps, ready });
+  }
+  if (options.json) {
+    console.log(JSON.stringify(results, null, 2));
+    return;
+  }
+  const allReady = results.every((r) => r.ready);
+  console.log(chalk2.bold(`
+Skills Test (${results.length} skill${results.length === 1 ? "" : "s"}):
+`));
+  for (const result of results) {
+    const readyLabel = result.ready ? chalk2.green("ready") : chalk2.red("not ready");
+    console.log(chalk2.bold(`  ${result.skill}`) + chalk2.dim(` [${readyLabel}]`));
+    if (result.envVars.length === 0 && result.systemDeps.length === 0) {
+      console.log(chalk2.dim("    No requirements"));
+    }
+    for (const v of result.envVars) {
+      if (v.set) {
+        console.log(`    ${chalk2.green("\u2713")} ${v.name}`);
+      } else {
+        console.log(`    ${chalk2.red("\u2717")} ${v.name} ${chalk2.dim("(missing)")}`);
+      }
+    }
+    for (const dep of result.systemDeps) {
+      if (dep.available) {
+        console.log(`    ${chalk2.green("\u2713")} ${dep.name} ${chalk2.dim("(system)")}`);
+      } else {
+        console.log(`    ${chalk2.red("\u2717")} ${dep.name} ${chalk2.dim("(not installed)")}`);
+      }
+    }
+    if (result.npmDeps.length > 0) {
+      console.log(chalk2.dim(`    npm: ${result.npmDeps.map((d) => d.name).join(", ")}`));
+    }
+  }
+  console.log();
+  if (allReady) {
+    console.log(chalk2.green(`All ${results.length} skill(s) ready`));
+  } else {
+    const notReady = results.filter((r) => !r.ready).length;
+    console.log(chalk2.yellow(`${notReady} skill(s) not ready`));
+  }
+  if (!allReady) {
+    process.exitCode = 1;
+  }
+});
 program2.command("outdated").option("--json", "Output as JSON", false).description("Check for outdated installed skills").action((options) => {
   const installed = getInstalledSkills();
   if (installed.length === 0) {
@@ -37392,17 +38024,17 @@ program2.command("outdated").option("--json", "Output as JSON", false).descripti
   const upToDate = [];
   for (const name of installed) {
     const skillName = normalizeSkillName(name);
-    const installedPkgPath = join4(cwd, ".skills", skillName, "package.json");
+    const installedPkgPath = join5(cwd, ".skills", skillName, "package.json");
     let installedVersion = "unknown";
-    if (existsSync4(installedPkgPath)) {
+    if (existsSync5(installedPkgPath)) {
       try {
         installedVersion = JSON.parse(readFileSync4(installedPkgPath, "utf-8")).version || "unknown";
       } catch {}
     }
     const registryPath = getSkillPath(name);
-    const registryPkgPath = join4(registryPath, "package.json");
+    const registryPkgPath = join5(registryPath, "package.json");
     let registryVersion = "unknown";
-    if (existsSync4(registryPkgPath)) {
+    if (existsSync5(registryPkgPath)) {
       try {
         registryVersion = JSON.parse(readFileSync4(registryPkgPath, "utf-8")).version || "unknown";
       } catch {}

package/bin/mcp.js

@@ -28596,10 +28596,15 @@ class StdioServerTransport {
     });
   }
 }
+
+// src/mcp/index.ts
+import { existsSync as existsSync3, readdirSync as readdirSync3, statSync as statSync2 } from "fs";
+import { join as join3 } from "path";
+import { homedir as homedir2 } from "os";
 // package.json
 var package_default = {
   name: "@hasna/skills",
-  version: "0.1.7",
+  version: "0.1.8",
   description: "Skills library for AI coding agents",
   type: "module",
   bin: {
@@ -30709,6 +30714,52 @@ server.registerTool("install_skill", {
     isError: !result.success
   };
 });
+server.registerTool("install_category", {
+  title: "Install Category",
+  description: "Install all skills in a category. Optionally install for a specific agent (claude, codex, gemini, or all) with a given scope.",
+  inputSchema: {
+    category: exports_external.string().describe("Category name (case-insensitive, e.g. 'Event Management')"),
+    for: exports_external.string().optional().describe("Agent target: claude, codex, gemini, or all"),
+    scope: exports_external.string().optional().describe("Install scope: global or project (default: global)")
+  }
+}, async ({ category, for: agentArg, scope }) => {
+  const matchedCategory = CATEGORIES.find((c) => c.toLowerCase() === category.toLowerCase());
+  if (!matchedCategory) {
+    return {
+      content: [{ type: "text", text: `Unknown category: ${category}. Available: ${CATEGORIES.join(", ")}` }],
+      isError: true
+    };
+  }
+  const categorySkills = getSkillsByCategory(matchedCategory);
+  const names = categorySkills.map((s) => s.name);
+  if (agentArg) {
+    let agents;
+    try {
+      agents = resolveAgents(agentArg);
+    } catch (err) {
+      return {
+        content: [{ type: "text", text: err.message }],
+        isError: true
+      };
+    }
+    const results2 = [];
+    for (const name of names) {
+      for (const a of agents) {
+        const r = installSkillForAgent(name, { agent: a, scope: scope || "global" }, generateSkillMd);
+        results2.push({ ...r, agent: a, scope: scope || "global" });
+      }
+    }
+    return {
+      content: [{ type: "text", text: JSON.stringify({ category: matchedCategory, count: names.length, results: results2 }, null, 2) }],
+      isError: results2.some((r) => !r.success)
+    };
+  }
+  const results = names.map((name) => installSkill(name));
+  return {
+    content: [{ type: "text", text: JSON.stringify({ category: matchedCategory, count: names.length, results }, null, 2) }],
+    isError: results.some((r) => !r.success)
+  };
+});
 server.registerTool("remove_skill", {
   title: "Remove Skill",
   description: "Remove an installed skill. Without --for, removes from .skills/. With --for, removes from agent skill directory.",
@@ -30801,6 +30852,94 @@ server.registerTool("run_skill", {
     content: [{ type: "text", text: JSON.stringify({ exitCode: result.exitCode, skill: name }, null, 2) }]
   };
 });
+server.registerTool("export_skills", {
+  title: "Export Skills",
+  description: "Export the list of currently installed skills as a JSON payload that can be imported elsewhere"
+}, async () => {
+  const skills = getInstalledSkills();
+  const payload = {
+    version: 1,
+    skills,
+    timestamp: new Date().toISOString()
+  };
+  return { content: [{ type: "text", text: JSON.stringify(payload, null, 2) }] };
+});
+server.registerTool("import_skills", {
+  title: "Import Skills",
+  description: "Install a list of skills from an export payload. Supports agent-specific installs via the 'for' parameter.",
+  inputSchema: {
+    skills: exports_external.array(exports_external.string()).describe("List of skill names to install"),
+    for: exports_external.string().optional().describe("Agent target: claude, codex, gemini, or all"),
+    scope: exports_external.string().optional().describe("Install scope: global or project (default: global)")
+  }
+}, async ({ skills: skillList, for: agentArg, scope }) => {
+  if (!skillList || skillList.length === 0) {
+    return { content: [{ type: "text", text: JSON.stringify({ imported: 0, results: [] }, null, 2) }] };
+  }
+  const results = [];
+  if (agentArg) {
+    let agents;
+    try {
+      agents = resolveAgents(agentArg);
+    } catch (err) {
+      return {
+        content: [{ type: "text", text: err.message }],
+        isError: true
+      };
+    }
+    for (const name of skillList) {
+      const agentResults = agents.map((a) => installSkillForAgent(name, { agent: a, scope: scope || "global" }, generateSkillMd));
+      const success2 = agentResults.every((r) => r.success);
+      const errors3 = agentResults.filter((r) => !r.success).map((r) => r.error).filter(Boolean);
+      results.push({ skill: name, success: success2, ...errors3.length > 0 ? { error: errors3.join("; ") } : {} });
+    }
+  } else {
+    for (const name of skillList) {
+      const result = installSkill(name);
+      results.push({ skill: result.skill, success: result.success, ...result.error ? { error: result.error } : {} });
+    }
+  }
+  const imported = results.filter((r) => r.success).length;
+  const hasErrors = results.some((r) => !r.success);
+  return {
+    content: [{ type: "text", text: JSON.stringify({ imported, total: skillList.length, results }, null, 2) }],
+    isError: hasErrors
+  };
+});
+server.registerTool("whoami", {
+  title: "Skills Whoami",
+  description: "Show setup summary: package version, installed skills, agent configurations, skills directory location, and working directory"
+}, async () => {
+  const version2 = package_default.version;
+  const cwd = process.cwd();
+  const installed = getInstalledSkills();
+  const agentNames = ["claude", "codex", "gemini"];
+  const agents = [];
+  for (const agent of agentNames) {
+    const agentSkillsPath = join3(homedir2(), `.${agent}`, "skills");
+    const exists = existsSync3(agentSkillsPath);
+    let skillCount = 0;
+    if (exists) {
+      try {
+        skillCount = readdirSync3(agentSkillsPath).filter((f) => {
+          const full = join3(agentSkillsPath, f);
+          return f.startsWith("skill-") && statSync2(full).isDirectory();
+        }).length;
+      } catch {}
+    }
+    agents.push({ agent, path: agentSkillsPath, exists, skillCount });
+  }
+  const skillsDir = getSkillPath("image").replace(/[/\\][^/\\]*$/, "");
+  const result = {
+    version: version2,
+    installedCount: installed.length,
+    installed,
+    agents,
+    skillsDir,
+    cwd
+  };
+  return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+});
 server.registerResource("Skills Registry", "skills://registry", {
   description: "Full list of all available skills as JSON"
 }, async () => ({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hasna/skills",
-  "version": "0.1.7",
+  "version": "0.1.8",
   "description": "Skills library for AI coding agents",
   "type": "module",
   "bin": {