@hasna/skills 0.1.9 → 0.1.11

package/bin/index.js

@@ -1878,7 +1878,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@hasna/skills",
-    version: "0.1.9",
+    version: "0.1.11",
     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) {
@@ -35143,6 +35143,57 @@ 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() }
+  }, async ({ query }) => {
+    const all = [
+      "list_skills",
+      "search_skills",
+      "get_skill_info",
+      "get_skill_docs",
+      "install_skill",
+      "install_category",
+      "remove_skill",
+      "list_categories",
+      "list_tags",
+      "get_requirements",
+      "run_skill",
+      "export_skills",
+      "import_skills",
+      "whoami",
+      "search_tools",
+      "describe_tools"
+    ];
+    const matches = query ? all.filter((n) => n.includes(query.toLowerCase())) : all;
+    return { content: [{ type: "text", text: matches.join(", ") }] };
+  });
+  server.registerTool("describe_tools", {
+    title: "Describe Tools",
+    description: "Get descriptions for specific tools by name.",
+    inputSchema: { names: exports_external.array(exports_external.string()) }
+  }, async ({ names }) => {
+    const descriptions = {
+      list_skills: "List skills {name,category}. Params: category?, detail?",
+      search_skills: "Search skills by name/tags. Params: query, detail?",
+      get_skill_info: "Get skill metadata and env vars. Params: name",
+      get_skill_docs: "Get skill documentation. Params: name",
+      install_skill: "Install a skill for an agent. Params: name, agent?",
+      install_category: "Install all skills in a category. Params: category, agent?",
+      remove_skill: "Remove an installed skill. Params: name, agent?",
+      list_categories: "List skill categories with counts.",
+      list_tags: "List all tags across skills.",
+      get_requirements: "Get skill requirements/dependencies. Params: name",
+      run_skill: "Execute a skill. Params: name, args?",
+      export_skills: "Export skill config. Params: format?",
+      import_skills: "Import skill config. Params: data",
+      whoami: "Show setup: version, installed skills, agent configs."
+    };
+    const result = names.map((n) => `${n}: ${descriptions[n] || "See tool schema"}`).join(`
+`);
+    return { content: [{ type: "text", text: result }] };
+  });
   main().catch((error48) => {
     console.error("MCP server error:", error48);
     process.exit(1);

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.9",
+  version: "0.1.11",
   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) {
@@ -30971,6 +30971,57 @@ 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() }
+}, async ({ query }) => {
+  const all = [
+    "list_skills",
+    "search_skills",
+    "get_skill_info",
+    "get_skill_docs",
+    "install_skill",
+    "install_category",
+    "remove_skill",
+    "list_categories",
+    "list_tags",
+    "get_requirements",
+    "run_skill",
+    "export_skills",
+    "import_skills",
+    "whoami",
+    "search_tools",
+    "describe_tools"
+  ];
+  const matches = query ? all.filter((n) => n.includes(query.toLowerCase())) : all;
+  return { content: [{ type: "text", text: matches.join(", ") }] };
+});
+server.registerTool("describe_tools", {
+  title: "Describe Tools",
+  description: "Get descriptions for specific tools by name.",
+  inputSchema: { names: exports_external.array(exports_external.string()) }
+}, async ({ names }) => {
+  const descriptions = {
+    list_skills: "List skills {name,category}. Params: category?, detail?",
+    search_skills: "Search skills by name/tags. Params: query, detail?",
+    get_skill_info: "Get skill metadata and env vars. Params: name",
+    get_skill_docs: "Get skill documentation. Params: name",
+    install_skill: "Install a skill for an agent. Params: name, agent?",
+    install_category: "Install all skills in a category. Params: category, agent?",
+    remove_skill: "Remove an installed skill. Params: name, agent?",
+    list_categories: "List skill categories with counts.",
+    list_tags: "List all tags across skills.",
+    get_requirements: "Get skill requirements/dependencies. Params: name",
+    run_skill: "Execute a skill. Params: name, args?",
+    export_skills: "Export skill config. Params: format?",
+    import_skills: "Import skill config. Params: data",
+    whoami: "Show setup: version, installed skills, agent configs."
+  };
+  const result = names.map((n) => `${n}: ${descriptions[n] || "See tool schema"}`).join(`
+`);
+  return { content: [{ type: "text", text: result }] };
+});
 async function main() {
   const transport = new StdioServerTransport;
   await server.connect(transport);

package/package.json

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