@hasna/skills 0.1.7 → 0.1.9

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.9",
     description: "Skills library for AI coding agents",
     type: "module",
     bin: {
@@ -34782,6 +34782,12 @@ 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";
+function stripNulls(obj) {
+  return Object.fromEntries(Object.entries(obj).filter(([, v]) => v !== null && v !== undefined && !(Array.isArray(v) && v.length === 0)));
+}
 async function main() {
   const transport = new StdioServerTransport;
   await server.connect(transport);
@@ -34801,33 +34807,37 @@ var init_mcp2 = __esm(() => {
   });
   server.registerTool("list_skills", {
     title: "List Skills",
-    description: "List all available skills, optionally filtered by category",
+    description: "List skills. Returns {name,category} by default; detail:true for full objects.",
     inputSchema: {
-      category: exports_external.string().optional().describe("Filter by category name")
+      category: exports_external.string().optional().describe("Filter by category"),
+      detail: exports_external.boolean().optional().describe("Return full objects (default: false)")
     }
-  }, async ({ category }) => {
+  }, async ({ category, detail }) => {
     const skills = category ? getSkillsByCategory(category) : SKILLS;
+    const result = detail ? skills : skills.map((s) => ({ name: s.name, category: s.category }));
     return {
-      content: [{ type: "text", text: JSON.stringify(skills, null, 2) }]
+      content: [{ type: "text", text: JSON.stringify(result) }]
     };
   });
   server.registerTool("search_skills", {
     title: "Search Skills",
-    description: "Search skills by query string (matches name, description, and tags)",
+    description: "Search skills by name, description, or tags. Returns compact list by default.",
     inputSchema: {
-      query: exports_external.string().describe("Search query")
+      query: exports_external.string().describe("Search query (fuzzy-matched)"),
+      detail: exports_external.boolean().optional().describe("Return full objects (default: false)")
     }
-  }, async ({ query }) => {
+  }, async ({ query, detail }) => {
     const results = searchSkills(query);
+    const out = detail ? results : results.map((s) => ({ name: s.name, category: s.category }));
     return {
-      content: [{ type: "text", text: JSON.stringify(results, null, 2) }]
+      content: [{ type: "text", text: JSON.stringify(out) }]
     };
   });
   server.registerTool("get_skill_info", {
     title: "Get Skill Info",
-    description: "Get detailed metadata about a skill including requirements, env vars, and dependencies",
+    description: "Get skill metadata, env vars, and dependencies.",
     inputSchema: {
-      name: exports_external.string().describe("Skill name (e.g. 'image', 'deep-research')")
+      name: exports_external.string().describe("Skill name (e.g. 'image')")
     }
   }, async ({ name }) => {
     const skill = getSkill(name);
@@ -34835,13 +34845,14 @@ var init_mcp2 = __esm(() => {
       return { content: [{ type: "text", text: `Skill '${name}' not found` }], isError: true };
     }
     const reqs = getSkillRequirements(name);
+    const result = stripNulls({ ...skill, ...reqs });
     return {
-      content: [{ type: "text", text: JSON.stringify({ ...skill, ...reqs }, null, 2) }]
+      content: [{ type: "text", text: JSON.stringify(result) }]
     };
   });
   server.registerTool("get_skill_docs", {
     title: "Get Skill Docs",
-    description: "Get documentation for a skill (SKILL.md, README.md, or CLAUDE.md)",
+    description: "Get skill documentation (SKILL.md > README.md > CLAUDE.md).",
     inputSchema: {
       name: exports_external.string().describe("Skill name")
     }
@@ -34854,7 +34865,7 @@ var init_mcp2 = __esm(() => {
   });
   server.registerTool("install_skill", {
     title: "Install Skill",
-    description: "Install a skill. Without --for, installs full source to .skills/. With --for, copies SKILL.md to agent skill directory.",
+    description: "Install a skill to .skills/ or to an agent dir (for: claude|codex|gemini|all).",
     inputSchema: {
       name: exports_external.string().describe("Skill name to install"),
       for: exports_external.string().optional().describe("Agent target: claude, codex, gemini, or all"),
@@ -34883,9 +34894,55 @@ var init_mcp2 = __esm(() => {
       isError: !result.success
     };
   });
+  server.registerTool("install_category", {
+    title: "Install Category",
+    description: "Install all skills in a category, optionally for a specific agent.",
+    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.",
+    description: "Remove a skill from .skills/ or from an agent dir.",
     inputSchema: {
       name: exports_external.string().describe("Skill name to remove"),
       for: exports_external.string().optional().describe("Agent target: claude, codex, gemini, or all"),
@@ -34918,7 +34975,7 @@ var init_mcp2 = __esm(() => {
   });
   server.registerTool("list_categories", {
     title: "List Categories",
-    description: "List all skill categories with counts"
+    description: "List all 17 skill categories with skill counts."
   }, async () => {
     const cats = CATEGORIES.map((category) => ({
       name: category,
@@ -34928,7 +34985,7 @@ var init_mcp2 = __esm(() => {
   });
   server.registerTool("list_tags", {
     title: "List Tags",
-    description: "List all unique tags across all skills with their occurrence counts"
+    description: "List all unique skill tags with occurrence counts."
   }, async () => {
     const tagCounts = new Map;
     for (const skill of SKILLS) {
@@ -34941,7 +34998,7 @@ var init_mcp2 = __esm(() => {
   });
   server.registerTool("get_requirements", {
     title: "Get Requirements",
-    description: "Get environment variables, system dependencies, and npm dependencies for a skill",
+    description: "Get env vars, system deps, and npm dependencies for a skill.",
     inputSchema: {
       name: exports_external.string().describe("Skill name")
     }
@@ -34954,7 +35011,7 @@ var init_mcp2 = __esm(() => {
   });
   server.registerTool("run_skill", {
     title: "Run Skill",
-    description: "Run a skill by name with optional arguments. Returns the exit code and any error message.",
+    description: "Run a skill by name with optional arguments.",
     inputSchema: {
       name: exports_external.string().describe("Skill name to run"),
       args: exports_external.array(exports_external.string()).optional().describe("Arguments to pass to the skill")
@@ -34975,12 +35032,100 @@ 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 installed skills as a JSON payload for import 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 skills from an export payload. Supports agent installs via 'for'.",
+    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: version, installed skills, agent configs, cwd."
+  }, 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"
+    description: "Compact skill list [{name,category}]. Use skills://{name} for detail."
   }, async () => ({
     contents: [{
       uri: "skills://registry",
-      text: JSON.stringify(SKILLS, null, 2),
+      text: JSON.stringify(SKILLS.map((s) => ({ name: s.name, category: s.category }))),
       mimeType: "application/json"
     }]
   }));
@@ -35010,15 +35155,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 +35175,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 +35222,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 +35232,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 +35346,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 +35395,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 +35468,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 +35484,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 +35564,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";
@@ -36469,12 +36695,33 @@ var program2 = new Command;
 program2.name("skills").description("Install AI agent skills for your project").version(package_default.version).option("--verbose", "Enable verbose logging", false).enablePositionalOptions();
 program2.command("interactive", { isDefault: true }).alias("i").description("Interactive skill browser (TUI)").action(() => {
   if (!isTTY) {
-    console.log(JSON.stringify(SKILLS, null, 2));
+    console.log(JSON.stringify(SKILLS.map((s) => ({ name: s.name, category: s.category }))));
     process.exit(0);
   }
   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 +36808,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 +36820,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 +36851,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 +36871,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 +36889,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 +36911,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 +36927,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 +36936,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 +36950,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 +36962,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 +37196,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 +37207,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 +37320,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 +37337,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 +37418,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 +37432,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 +37441,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 +37503,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 +37627,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 +37776,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 +38032,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 {}