@hasna/skills 0.1.8 → 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.8",
+    version: "0.1.9",
     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"
     }]
   }));
@@ -36687,7 +36695,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.9",
   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"
   }]
 }));

package/package.json

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