@hasna/skills 0.1.10 → 0.1.12

package/bin/index.js

@@ -1878,7 +1878,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@hasna/skills",
-    version: "0.1.10",
+    version: "0.1.12",
     description: "Skills library for AI coding agents",
     type: "module",
     bin: {
@@ -34809,8 +34809,8 @@ var init_mcp2 = __esm(() => {
     title: "List Skills",
     description: "List skills. Returns {name,category} by default; detail:true for full objects.",
     inputSchema: {
-      category: exports_external.string().optional().describe("Filter by category"),
-      detail: exports_external.boolean().optional().describe("Return full objects (default: false)")
+      category: exports_external.string().optional(),
+      detail: exports_external.boolean().optional()
     }
   }, async ({ category, detail }) => {
     const skills = category ? getSkillsByCategory(category) : SKILLS;
@@ -34823,8 +34823,8 @@ var init_mcp2 = __esm(() => {
     title: "Search Skills",
     description: "Search skills by name, description, or tags. Returns compact list by default.",
     inputSchema: {
-      query: exports_external.string().describe("Search query (fuzzy-matched)"),
-      detail: exports_external.boolean().optional().describe("Return full objects (default: false)")
+      query: exports_external.string(),
+      detail: exports_external.boolean().optional()
     }
   }, async ({ query, detail }) => {
     const results = searchSkills(query);
@@ -34837,7 +34837,7 @@ var init_mcp2 = __esm(() => {
     title: "Get Skill Info",
     description: "Get skill metadata, env vars, and dependencies.",
     inputSchema: {
-      name: exports_external.string().describe("Skill name (e.g. 'image')")
+      name: exports_external.string()
     }
   }, async ({ name }) => {
     const skill = getSkill(name);
@@ -34854,7 +34854,7 @@ var init_mcp2 = __esm(() => {
     title: "Get Skill Docs",
     description: "Get skill documentation (SKILL.md > README.md > CLAUDE.md).",
     inputSchema: {
-      name: exports_external.string().describe("Skill name")
+      name: exports_external.string()
     }
   }, async ({ name }) => {
     const doc2 = getSkillBestDoc(name);
@@ -34867,9 +34867,9 @@ var init_mcp2 = __esm(() => {
     title: "Install Skill",
     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"),
-      scope: exports_external.string().optional().describe("Install scope: global or project (default: global)")
+      name: exports_external.string(),
+      for: exports_external.string().optional(),
+      scope: exports_external.string().optional()
     }
   }, async ({ name, for: agentArg, scope }) => {
     if (agentArg) {
@@ -34898,9 +34898,9 @@ var init_mcp2 = __esm(() => {
     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)")
+      category: exports_external.string(),
+      for: exports_external.string().optional(),
+      scope: exports_external.string().optional()
     }
   }, async ({ category, for: agentArg, scope }) => {
     const matchedCategory = CATEGORIES.find((c) => c.toLowerCase() === category.toLowerCase());
@@ -34944,9 +34944,9 @@ var init_mcp2 = __esm(() => {
     title: "Remove Skill",
     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"),
-      scope: exports_external.string().optional().describe("Remove scope: global or project (default: global)")
+      name: exports_external.string(),
+      for: exports_external.string().optional(),
+      scope: exports_external.string().optional()
     }
   }, async ({ name, for: agentArg, scope }) => {
     if (agentArg) {
@@ -35000,7 +35000,7 @@ var init_mcp2 = __esm(() => {
     title: "Get Requirements",
     description: "Get env vars, system deps, and npm dependencies for a skill.",
     inputSchema: {
-      name: exports_external.string().describe("Skill name")
+      name: exports_external.string()
     }
   }, async ({ name }) => {
     const reqs = getSkillRequirements(name);
@@ -35013,8 +35013,8 @@ var init_mcp2 = __esm(() => {
     title: "Run Skill",
     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")
+      name: exports_external.string(),
+      args: exports_external.array(exports_external.string()).optional()
     }
   }, async ({ name, args }) => {
     const skill = getSkill(name);
@@ -35048,9 +35048,9 @@ var init_mcp2 = __esm(() => {
     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)")
+      skills: exports_external.array(exports_external.string()),
+      for: exports_external.string().optional(),
+      scope: exports_external.string().optional()
     }
   }, async ({ skills: skillList, for: agentArg, scope }) => {
     if (!skillList || skillList.length === 0) {
@@ -35146,7 +35146,7 @@ var init_mcp2 = __esm(() => {
   server.registerTool("search_tools", {
     title: "Search Tools",
     description: "List tool names, optionally filtered by keyword.",
-    inputSchema: { query: exports_external.string().optional().describe("Keyword filter") }
+    inputSchema: { query: exports_external.string().optional() }
   }, async ({ query }) => {
     const all = [
       "list_skills",
@@ -35172,7 +35172,7 @@ var init_mcp2 = __esm(() => {
   server.registerTool("describe_tools", {
     title: "Describe Tools",
     description: "Get descriptions for specific tools by name.",
-    inputSchema: { names: exports_external.array(exports_external.string()).describe("Tool names from search_tools") }
+    inputSchema: { names: exports_external.array(exports_external.string()) }
   }, async ({ names }) => {
     const descriptions = {
       list_skills: "List skills {name,category}. Params: category?, detail?",
@@ -35253,6 +35253,18 @@ function json2(data, status = 200) {
 function isValidSkillName(name) {
   return /^[a-z0-9-]+$/.test(name);
 }
+function pickFields(obj, fields) {
+  if (fields.length === 0)
+    return obj;
+  const rec = obj;
+  return Object.fromEntries(fields.filter((f) => (f in rec)).map((f) => [f, rec[f]]));
+}
+function parseFields(searchParams) {
+  const raw = searchParams.get("fields");
+  if (!raw)
+    return [];
+  return raw.split(",").map((f) => f.trim()).filter(Boolean);
+}
 function getAllSkillsWithStatus() {
   const installed = new Set(getInstalledSkills());
   return SKILLS.map((meta3) => {
@@ -35289,7 +35301,9 @@ function createFetchHandler(options) {
     const path = url2.pathname;
     const method = req.method;
     if (path === "/api/skills" && method === "GET") {
-      return json2(getAllSkillsWithStatus());
+      const fields = parseFields(url2.searchParams);
+      const skills = getAllSkillsWithStatus();
+      return json2(fields.length ? skills.map((s) => pickFields(s, fields)) : skills);
     }
     if (path === "/api/categories" && method === "GET") {
       const counts = CATEGORIES.map((cat) => ({
@@ -35312,12 +35326,13 @@ function createFetchHandler(options) {
       const query = url2.searchParams.get("q") || "";
       if (!query.trim())
         return json2([]);
+      const fields = parseFields(url2.searchParams);
       const results = searchSkills(query);
       const installed = new Set(getInstalledSkills());
-      return json2(results.map((meta3) => {
+      const mapped = results.map((meta3) => {
         const reqs = getSkillRequirements(meta3.name);
         const envVars = reqs?.envVars || [];
-        return {
+        const obj = {
           name: meta3.name,
           displayName: meta3.displayName,
           description: meta3.description,
@@ -35329,7 +35344,9 @@ function createFetchHandler(options) {
           systemDeps: reqs?.systemDeps || [],
           cliCommand: reqs?.cliCommand || null
         };
-      }));
+        return fields.length ? pickFields(obj, fields) : obj;
+      });
+      return json2(mapped);
     }
     const singleMatch = path.match(/^\/api\/skills\/([^/]+)$/);
     if (singleMatch && method === "GET") {
@@ -35339,11 +35356,12 @@ function createFetchHandler(options) {
       const meta3 = getSkill(name);
       if (!meta3)
         return json2({ error: `Skill '${name}' not found` }, 404);
+      const fields = parseFields(url2.searchParams);
       const reqs = getSkillRequirements(name);
       const docs = getSkillBestDoc(name);
       const installed = new Set(getInstalledSkills());
       const envVars = reqs?.envVars || [];
-      return json2({
+      const obj = {
         name: meta3.name,
         displayName: meta3.displayName,
         description: meta3.description,
@@ -35355,7 +35373,8 @@ function createFetchHandler(options) {
         systemDeps: reqs?.systemDeps || [],
         cliCommand: reqs?.cliCommand || null,
         docs: docs || null
-      });
+      };
+      return json2(fields.length ? pickFields(obj, fields) : obj);
     }
     const docsMatch = path.match(/^\/api\/skills\/([^/]+)\/docs$/);
     if (docsMatch && method === "GET") {
@@ -35383,18 +35402,13 @@ function createFetchHandler(options) {
           const results = agents.map((agent) => installSkillForAgent(name, { agent, scope }, generateSkillMd));
           const allSuccess = results.every((r) => r.success);
           const errors4 = results.filter((r) => !r.success).map((r) => r.error);
-          return json2({
-            skill: name,
-            success: allSuccess,
-            results,
-            ...errors4.length > 0 ? { error: errors4.join("; ") } : {}
-          }, allSuccess ? 200 : 400);
+          return json2(allSuccess ? { skill: name, success: true } : { skill: name, success: false, results, error: errors4.join("; ") }, allSuccess ? 200 : 400);
         } catch (e) {
           return json2({ skill: name, success: false, error: e instanceof Error ? e.message : "Unknown error" }, 400);
         }
       } else {
         const result = installSkill(name);
-        return json2(result, result.success ? 200 : 400);
+        return json2(result.success ? { skill: name, success: true } : { skill: name, success: false, error: result.error }, result.success ? 200 : 400);
       }
     }
     if (path === "/api/skills/install-category" && method === "POST") {
@@ -36859,8 +36873,9 @@ 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).option("--brief", "One line per skill: name \u2014 description [category]", 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).option("--format <format>", "Output format: compact (names only) or csv (name,category,description)").description("List available or installed skills").action((options) => {
   const brief = options.brief && !options.json;
+  const fmt = !options.json ? options.format : undefined;
   if (options.installed) {
     const installed = getInstalledSkills();
     if (options.json) {
@@ -36940,6 +36955,19 @@ Skills matching tags [${tagFilter.join(", ")}] (${skills.length}):
     console.log(JSON.stringify(SKILLS, null, 2));
     return;
   }
+  if (fmt === "compact") {
+    for (const s of SKILLS)
+      console.log(s.name);
+    return;
+  }
+  if (fmt === "csv") {
+    console.log("name,category,description");
+    for (const s of SKILLS) {
+      const desc = s.description.replace(/"/g, '""');
+      console.log(`${s.name},${s.category},"${desc}"`);
+    }
+    return;
+  }
   if (brief) {
     const sorted = [...SKILLS].sort((a, b) => {
       const catCmp = a.category.localeCompare(b.category);
@@ -36962,7 +36990,7 @@ Available skills (${SKILLS.length}):
     console.log();
   }
 });
-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) => {
+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("--format <format>", "Output format: compact (names only) or csv (name,category,description)").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());
@@ -36979,6 +37007,7 @@ program2.command("search").argument("<query>", "Search term").option("--json", "
     results = results.filter((s) => s.tags.some((tag) => tagFilter.includes(tag.toLowerCase())));
   }
   const brief = options.brief && !options.json;
+  const fmt = !options.json ? options.format : undefined;
   if (options.json) {
     console.log(JSON.stringify(results, null, 2));
     return;
@@ -36987,6 +37016,19 @@ program2.command("search").argument("<query>", "Search term").option("--json", "
     console.log(chalk2.dim(`No skills found for "${query}"`));
     return;
   }
+  if (fmt === "compact") {
+    for (const s of results)
+      console.log(s.name);
+    return;
+  }
+  if (fmt === "csv") {
+    console.log("name,category,description");
+    for (const s of results) {
+      const desc = s.description.replace(/"/g, '""');
+      console.log(`${s.name},${s.category},"${desc}"`);
+    }
+    return;
+  }
   if (brief) {
     for (const s of results) {
       console.log(`${s.name} \u2014 ${s.description} [${s.category}]`);

package/bin/mcp.js

@@ -28604,7 +28604,7 @@ import { homedir as homedir2 } from "os";
 // package.json
 var package_default = {
   name: "@hasna/skills",
-  version: "0.1.10",
+  version: "0.1.12",
   description: "Skills library for AI coding agents",
   type: "module",
   bin: {
@@ -30637,8 +30637,8 @@ server.registerTool("list_skills", {
   title: "List Skills",
   description: "List skills. Returns {name,category} by default; detail:true for full objects.",
   inputSchema: {
-    category: exports_external.string().optional().describe("Filter by category"),
-    detail: exports_external.boolean().optional().describe("Return full objects (default: false)")
+    category: exports_external.string().optional(),
+    detail: exports_external.boolean().optional()
   }
 }, async ({ category, detail }) => {
   const skills = category ? getSkillsByCategory(category) : SKILLS;
@@ -30651,8 +30651,8 @@ server.registerTool("search_skills", {
   title: "Search Skills",
   description: "Search skills by name, description, or tags. Returns compact list by default.",
   inputSchema: {
-    query: exports_external.string().describe("Search query (fuzzy-matched)"),
-    detail: exports_external.boolean().optional().describe("Return full objects (default: false)")
+    query: exports_external.string(),
+    detail: exports_external.boolean().optional()
   }
 }, async ({ query, detail }) => {
   const results = searchSkills(query);
@@ -30665,7 +30665,7 @@ server.registerTool("get_skill_info", {
   title: "Get Skill Info",
   description: "Get skill metadata, env vars, and dependencies.",
   inputSchema: {
-    name: exports_external.string().describe("Skill name (e.g. 'image')")
+    name: exports_external.string()
   }
 }, async ({ name }) => {
   const skill = getSkill(name);
@@ -30682,7 +30682,7 @@ server.registerTool("get_skill_docs", {
   title: "Get Skill Docs",
   description: "Get skill documentation (SKILL.md > README.md > CLAUDE.md).",
   inputSchema: {
-    name: exports_external.string().describe("Skill name")
+    name: exports_external.string()
   }
 }, async ({ name }) => {
   const doc2 = getSkillBestDoc(name);
@@ -30695,9 +30695,9 @@ server.registerTool("install_skill", {
   title: "Install Skill",
   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"),
-    scope: exports_external.string().optional().describe("Install scope: global or project (default: global)")
+    name: exports_external.string(),
+    for: exports_external.string().optional(),
+    scope: exports_external.string().optional()
   }
 }, async ({ name, for: agentArg, scope }) => {
   if (agentArg) {
@@ -30726,9 +30726,9 @@ 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)")
+    category: exports_external.string(),
+    for: exports_external.string().optional(),
+    scope: exports_external.string().optional()
   }
 }, async ({ category, for: agentArg, scope }) => {
   const matchedCategory = CATEGORIES.find((c) => c.toLowerCase() === category.toLowerCase());
@@ -30772,9 +30772,9 @@ server.registerTool("remove_skill", {
   title: "Remove Skill",
   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"),
-    scope: exports_external.string().optional().describe("Remove scope: global or project (default: global)")
+    name: exports_external.string(),
+    for: exports_external.string().optional(),
+    scope: exports_external.string().optional()
   }
 }, async ({ name, for: agentArg, scope }) => {
   if (agentArg) {
@@ -30828,7 +30828,7 @@ server.registerTool("get_requirements", {
   title: "Get Requirements",
   description: "Get env vars, system deps, and npm dependencies for a skill.",
   inputSchema: {
-    name: exports_external.string().describe("Skill name")
+    name: exports_external.string()
   }
 }, async ({ name }) => {
   const reqs = getSkillRequirements(name);
@@ -30841,8 +30841,8 @@ server.registerTool("run_skill", {
   title: "Run Skill",
   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")
+    name: exports_external.string(),
+    args: exports_external.array(exports_external.string()).optional()
   }
 }, async ({ name, args }) => {
   const skill = getSkill(name);
@@ -30876,9 +30876,9 @@ 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)")
+    skills: exports_external.array(exports_external.string()),
+    for: exports_external.string().optional(),
+    scope: exports_external.string().optional()
   }
 }, async ({ skills: skillList, for: agentArg, scope }) => {
   if (!skillList || skillList.length === 0) {
@@ -30974,7 +30974,7 @@ server.registerResource("Skill Info", new ResourceTemplate("skills://{name}", {
 server.registerTool("search_tools", {
   title: "Search Tools",
   description: "List tool names, optionally filtered by keyword.",
-  inputSchema: { query: exports_external.string().optional().describe("Keyword filter") }
+  inputSchema: { query: exports_external.string().optional() }
 }, async ({ query }) => {
   const all = [
     "list_skills",
@@ -31000,7 +31000,7 @@ server.registerTool("search_tools", {
 server.registerTool("describe_tools", {
   title: "Describe Tools",
   description: "Get descriptions for specific tools by name.",
-  inputSchema: { names: exports_external.array(exports_external.string()).describe("Tool names from search_tools") }
+  inputSchema: { names: exports_external.array(exports_external.string()) }
 }, async ({ names }) => {
   const descriptions = {
     list_skills: "List skills {name,category}. Params: category?, detail?",

package/package.json

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