@hasna/skills 0.1.8 → 0.1.10

package/bin/index.js

@@ -1878,7 +1878,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@hasna/skills",
-    version: "0.1.8",
+    version: "0.1.10",
     description: "Skills library for AI coding agents",
     type: "module",
     bin: {
@@ -34785,6 +34785,9 @@ 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);
@@ -34804,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);
@@ -34838,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")
     }
@@ -34857,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"),
@@ -34888,7 +34896,7 @@ var init_mcp2 = __esm(() => {
   });
   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.",
+    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"),
@@ -34934,7 +34942,7 @@ var init_mcp2 = __esm(() => {
   });
   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"),
@@ -34967,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,
@@ -34977,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) {
@@ -34990,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")
     }
@@ -35003,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")
@@ -35026,7 +35034,7 @@ var init_mcp2 = __esm(() => {
   });
   server.registerTool("export_skills", {
     title: "Export Skills",
-    description: "Export the list of currently installed skills as a JSON payload that can be imported elsewhere"
+    description: "Export installed skills as a JSON payload for import elsewhere."
   }, async () => {
     const skills = getInstalledSkills();
     const payload = {
@@ -35038,7 +35046,7 @@ var init_mcp2 = __esm(() => {
   });
   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.",
+    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"),
@@ -35080,7 +35088,7 @@ var init_mcp2 = __esm(() => {
   });
   server.registerTool("whoami", {
     title: "Skills Whoami",
-    description: "Show setup summary: package version, installed skills, agent configurations, skills directory location, and working directory"
+    description: "Show setup summary: version, installed skills, agent configs, cwd."
   }, async () => {
     const version2 = package_default.version;
     const cwd = process.cwd();
@@ -35113,11 +35121,11 @@ var init_mcp2 = __esm(() => {
     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"
     }]
   }));
@@ -35135,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().describe("Keyword filter") }
+  }, 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()).describe("Tool names from search_tools") }
+  }, 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);
@@ -36687,7 +36746,7 @@ 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));

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.8",
+  version: "0.1.10",
   description: "Skills library for AI coding agents",
   type: "module",
   bin: {
@@ -30630,35 +30630,42 @@ var server = new McpServer({
   name: "skills",
   version: package_default.version
 });
+function stripNulls(obj) {
+  return Object.fromEntries(Object.entries(obj).filter(([, v]) => v !== null && v !== undefined && !(Array.isArray(v) && v.length === 0)));
+}
 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);
@@ -30666,13 +30673,14 @@ server.registerTool("get_skill_info", {
     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")
   }
@@ -30685,7 +30693,7 @@ server.registerTool("get_skill_docs", {
 });
 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"),
@@ -30716,7 +30724,7 @@ server.registerTool("install_skill", {
 });
 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.",
+  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"),
@@ -30762,7 +30770,7 @@ server.registerTool("install_category", {
 });
 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"),
@@ -30795,7 +30803,7 @@ server.registerTool("remove_skill", {
 });
 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,
@@ -30805,7 +30813,7 @@ server.registerTool("list_categories", {
 });
 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) {
@@ -30818,7 +30826,7 @@ server.registerTool("list_tags", {
 });
 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")
   }
@@ -30831,7 +30839,7 @@ server.registerTool("get_requirements", {
 });
 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")
@@ -30854,7 +30862,7 @@ server.registerTool("run_skill", {
 });
 server.registerTool("export_skills", {
   title: "Export Skills",
-  description: "Export the list of currently installed skills as a JSON payload that can be imported elsewhere"
+  description: "Export installed skills as a JSON payload for import elsewhere."
 }, async () => {
   const skills = getInstalledSkills();
   const payload = {
@@ -30866,7 +30874,7 @@ server.registerTool("export_skills", {
 });
 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.",
+  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"),
@@ -30908,7 +30916,7 @@ server.registerTool("import_skills", {
 });
 server.registerTool("whoami", {
   title: "Skills Whoami",
-  description: "Show setup summary: package version, installed skills, agent configurations, skills directory location, and working directory"
+  description: "Show setup summary: version, installed skills, agent configs, cwd."
 }, async () => {
   const version2 = package_default.version;
   const cwd = process.cwd();
@@ -30941,11 +30949,11 @@ server.registerTool("whoami", {
   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"
   }]
 }));
@@ -30963,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().describe("Keyword filter") }
+}, 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()).describe("Tool names from search_tools") }
+}, 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.8",
+  "version": "0.1.10",
   "description": "Skills library for AI coding agents",
   "type": "module",
   "bin": {