@hasna/skills 0.1.5 → 0.1.6

package/bin/index.js

@@ -1878,7 +1878,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@hasna/skills",
-    version: "0.1.5",
+    version: "0.1.6",
     description: "Skills library for AI coding agents",
     type: "module",
     bin: {
@@ -1957,6 +1957,45 @@ var init_package = __esm(() => {
 function getSkillsByCategory(category) {
   return SKILLS.filter((s) => s.category === category);
 }
+function editDistance(a, b) {
+  if (a === b)
+    return 0;
+  if (a.length === 0)
+    return b.length;
+  if (b.length === 0)
+    return a.length;
+  const prev = Array.from({ length: b.length + 1 }, (_, i) => i);
+  const curr = new Array(b.length + 1);
+  for (let i = 1;i <= a.length; i++) {
+    curr[0] = i;
+    for (let j = 1;j <= b.length; j++) {
+      const cost = a[i - 1] === b[j - 1] ? 0 : 1;
+      curr[j] = Math.min(curr[j - 1] + 1, prev[j] + 1, prev[j - 1] + cost);
+    }
+    prev.splice(0, prev.length, ...curr);
+  }
+  return prev[b.length];
+}
+function fuzzyMatchScore(word, target) {
+  if (target.includes(word))
+    return 1;
+  const tokens = target.split(/[\s\-_]+/).filter(Boolean);
+  for (const token of tokens) {
+    if (token.startsWith(word))
+      return 0.6;
+  }
+  if (word.length >= 3) {
+    const maxDist = word.length <= 3 ? 1 : 2;
+    for (const token of tokens) {
+      if (Math.abs(token.length - word.length) <= maxDist) {
+        const dist = editDistance(word, token);
+        if (dist <= maxDist)
+          return 0.4;
+      }
+    }
+  }
+  return 0;
+}
 function searchSkills(query) {
   const words = query.toLowerCase().split(/\s+/).filter(Boolean);
   if (words.length === 0)
@@ -1967,30 +2006,28 @@ function searchSkills(query) {
     const displayNameLower = skill.displayName.toLowerCase();
     const descriptionLower = skill.description.toLowerCase();
     const tagsLower = skill.tags.map((t) => t.toLowerCase());
+    const tagsCombined = tagsLower.join(" ");
     let score = 0;
     let allWordsMatch = true;
     for (const word of words) {
-      let wordMatched = false;
-      if (nameLower.includes(word)) {
-        score += 10;
-        wordMatched = true;
-      }
-      if (displayNameLower.includes(word)) {
-        score += 7;
-        wordMatched = true;
-      }
-      if (tagsLower.some((t) => t.includes(word))) {
-        score += 5;
-        wordMatched = true;
-      }
-      if (descriptionLower.includes(word)) {
-        score += 2;
-        wordMatched = true;
-      }
-      if (!wordMatched) {
+      let wordScore = 0;
+      const nameMatch = fuzzyMatchScore(word, nameLower);
+      if (nameMatch > 0)
+        wordScore += 10 * nameMatch;
+      const displayMatch = fuzzyMatchScore(word, displayNameLower);
+      if (displayMatch > 0)
+        wordScore += 7 * displayMatch;
+      const tagMatch = Math.max(...tagsLower.map((t) => fuzzyMatchScore(word, t)), fuzzyMatchScore(word, tagsCombined));
+      if (tagMatch > 0)
+        wordScore += 5 * tagMatch;
+      const descMatch = fuzzyMatchScore(word, descriptionLower);
+      if (descMatch > 0)
+        wordScore += 2 * descMatch;
+      if (wordScore === 0) {
         allWordsMatch = false;
         break;
       }
+      score += wordScore;
     }
     if (allWordsMatch && score > 0) {
       scored.push({ skill, score });
@@ -5395,6 +5432,93 @@ async function runSkill(name, args, options = {}) {
   const exitCode = await proc.exited;
   return { exitCode };
 }
+function detectProjectSkills(cwd = process.cwd()) {
+  const pkgPath = join2(cwd, "package.json");
+  if (!existsSync2(pkgPath)) {
+    const alwaysRecommend = ["implementation-plan", "write", "deepresearch"];
+    const recommended2 = alwaysRecommend.map((name) => SKILLS.find((s) => s.name === name)).filter((s) => s !== undefined);
+    return { detected: [], recommended: recommended2 };
+  }
+  let pkg;
+  try {
+    pkg = JSON.parse(readFileSync2(pkgPath, "utf-8"));
+  } catch {
+    const alwaysRecommend = ["implementation-plan", "write", "deepresearch"];
+    const recommended2 = alwaysRecommend.map((name) => SKILLS.find((s) => s.name === name)).filter((s) => s !== undefined);
+    return { detected: [], recommended: recommended2 };
+  }
+  const allDeps = {
+    ...pkg.dependencies,
+    ...pkg.devDependencies
+  };
+  const depNames = Object.keys(allDeps);
+  const detected = [];
+  const recommendedNames = new Set;
+  for (const name of ["implementation-plan", "write", "deepresearch"]) {
+    recommendedNames.add(name);
+  }
+  const frontendDeps = ["next", "react", "vue", "svelte", "nuxt", "@nuxtjs/nuxt"];
+  for (const dep of frontendDeps) {
+    if (depNames.some((d) => d === dep || d.startsWith(`${dep}/`))) {
+      detected.push(dep);
+      for (const name of ["image", "generate-favicon", "seo-brief-builder"]) {
+        recommendedNames.add(name);
+      }
+      break;
+    }
+  }
+  const backendDeps = ["express", "fastify", "hono", "koa", "@hono/hono"];
+  for (const dep of backendDeps) {
+    if (depNames.some((d) => d === dep || d.startsWith(`${dep}/`))) {
+      detected.push(dep);
+      for (const name of ["api-test-suite", "apidocs"]) {
+        recommendedNames.add(name);
+      }
+      break;
+    }
+  }
+  const aiDeps = ["@anthropic-ai/sdk", "openai", "@openai/openai", "anthropic"];
+  for (const dep of aiDeps) {
+    if (depNames.includes(dep)) {
+      detected.push(dep);
+      for (const name of ["deepresearch", "webcrawling"]) {
+        recommendedNames.add(name);
+      }
+      break;
+    }
+  }
+  if (depNames.includes("stripe")) {
+    detected.push("stripe");
+    recommendedNames.add("invoice");
+  }
+  const emailDeps = ["nodemailer", "@sendgrid/mail", "@sendgrid/client"];
+  for (const dep of emailDeps) {
+    if (depNames.includes(dep)) {
+      detected.push(dep);
+      for (const name of ["gmail", "email-campaign"]) {
+        recommendedNames.add(name);
+      }
+      break;
+    }
+  }
+  const testDeps = ["vitest", "jest", "mocha", "@jest/core"];
+  for (const dep of testDeps) {
+    if (depNames.includes(dep)) {
+      detected.push(dep);
+      recommendedNames.add("api-test-suite");
+      break;
+    }
+  }
+  if (depNames.includes("typescript")) {
+    detected.push("typescript");
+    for (const name of ["scaffold-project", "deploy"]) {
+      recommendedNames.add(name);
+    }
+  }
+  const uniqueDetected = Array.from(new Set(detected));
+  const recommended = Array.from(recommendedNames).map((name) => SKILLS.find((s) => s.name === name)).filter((s) => s !== undefined);
+  return { detected: uniqueDetected, recommended };
+}
 function generateSkillMd(name) {
   const meta = getSkill(name);
   if (!meta)
@@ -34796,6 +34920,19 @@ var init_mcp2 = __esm(() => {
     }));
     return { content: [{ type: "text", text: JSON.stringify(cats, null, 2) }] };
   });
+  server.registerTool("list_tags", {
+    title: "List Tags",
+    description: "List all unique tags across all skills with their occurrence counts"
+  }, async () => {
+    const tagCounts = new Map;
+    for (const skill of SKILLS) {
+      for (const tag of skill.tags) {
+        tagCounts.set(tag, (tagCounts.get(tag) ?? 0) + 1);
+      }
+    }
+    const sorted = Array.from(tagCounts.entries()).sort(([a], [b]) => a.localeCompare(b)).map(([name, count]) => ({ name, count }));
+    return { content: [{ type: "text", text: JSON.stringify(sorted, null, 2) }] };
+  });
   server.registerTool("get_requirements", {
     title: "Get Requirements",
     description: "Get environment variables, system dependencies, and npm dependencies for a skill",
@@ -34959,6 +35096,16 @@ function createFetchHandler(options) {
       }));
       return json2(counts);
     }
+    if (path === "/api/tags" && method === "GET") {
+      const tagCounts = new Map;
+      for (const skill of SKILLS) {
+        for (const tag of skill.tags) {
+          tagCounts.set(tag, (tagCounts.get(tag) ?? 0) + 1);
+        }
+      }
+      const sorted = Array.from(tagCounts.entries()).sort(([a], [b]) => a.localeCompare(b)).map(([name, count]) => ({ name, count }));
+      return json2(sorted);
+    }
     if (path === "/api/skills/search" && method === "GET") {
       const query = url2.searchParams.get("q") || "";
       if (!query.trim())
@@ -36416,7 +36563,7 @@ 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("--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).description("List available or installed skills").action((options) => {
   if (options.installed) {
     const installed = getInstalledSkills();
     if (options.json) {
@@ -36435,6 +36582,7 @@ Installed skills (${installed.length}):
     }
     return;
   }
+  const tagFilter = options.tags ? options.tags.split(",").map((t) => t.trim().toLowerCase()).filter(Boolean) : null;
   if (options.category) {
     const category = CATEGORIES.find((c) => c.toLowerCase() === options.category.toLowerCase());
     if (!category) {
@@ -36443,7 +36591,10 @@ Installed skills (${installed.length}):
       process.exitCode = 1;
       return;
     }
-    const skills = getSkillsByCategory(category);
+    let skills = getSkillsByCategory(category);
+    if (tagFilter) {
+      skills = skills.filter((s) => s.tags.some((tag) => tagFilter.includes(tag.toLowerCase())));
+    }
     if (options.json) {
       console.log(JSON.stringify(skills, null, 2));
       return;
@@ -36456,6 +36607,20 @@ ${category} (${skills.length}):
     }
     return;
   }
+  if (tagFilter) {
+    const skills = SKILLS.filter((s) => s.tags.some((tag) => tagFilter.includes(tag.toLowerCase())));
+    if (options.json) {
+      console.log(JSON.stringify(skills, null, 2));
+      return;
+    }
+    console.log(chalk2.bold(`
+Skills matching tags [${tagFilter.join(", ")}] (${skills.length}):
+`));
+    for (const s of skills) {
+      console.log(`  ${chalk2.cyan(s.name)} ${chalk2.dim(`[${s.category}]`)} - ${s.description}`);
+    }
+    return;
+  }
   if (options.json) {
     console.log(JSON.stringify(SKILLS, null, 2));
     return;
@@ -36472,7 +36637,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").description("Search for skills").action((query, options) => {
+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) => {
   let results = searchSkills(query);
   if (options.category) {
     const category = CATEGORIES.find((c) => c.toLowerCase() === options.category.toLowerCase());
@@ -36484,6 +36649,10 @@ program2.command("search").argument("<query>", "Search term").option("--json", "
     }
     results = results.filter((s) => s.category === category);
   }
+  if (options.tags) {
+    const tagFilter = options.tags.split(",").map((t) => t.trim().toLowerCase()).filter(Boolean);
+    results = results.filter((s) => s.tags.some((tag) => tagFilter.includes(tag.toLowerCase())));
+  }
   if (options.json) {
     console.log(JSON.stringify(results, null, 2));
     return;
@@ -36628,10 +36797,76 @@ program2.command("run").argument("<skill>", "Skill name").argument("[args...]",
   }
   process.exitCode = result.exitCode;
 });
-program2.command("init").option("--json", "Output as JSON", false).description("Initialize project for installed skills (.env.example, .gitignore)").action((options) => {
+program2.command("init").option("--json", "Output as JSON", false).option("--for <agent>", "Detect project type and install recommended skills for agent: claude, codex, gemini, or all").option("--scope <scope>", "Install scope: global or project", "global").description("Initialize project for installed skills (.env.example, .gitignore)").action((options) => {
   const cwd = process.cwd();
+  if (options.for) {
+    let agents;
+    try {
+      agents = resolveAgents(options.for);
+    } catch (err) {
+      console.error(chalk2.red(err.message));
+      process.exitCode = 1;
+      return;
+    }
+    const { detected, recommended } = detectProjectSkills(cwd);
+    if (options.json) {
+      const installResults2 = [];
+      for (const skill of recommended) {
+        for (const agent of agents) {
+          const result = installSkillForAgent(skill.name, {
+            agent,
+            scope: options.scope
+          }, generateSkillMd);
+          installResults2.push({ ...result, agent, scope: options.scope });
+        }
+      }
+      console.log(JSON.stringify({
+        detected,
+        recommended: recommended.map((s) => s.name),
+        installed: installResults2
+      }, null, 2));
+      return;
+    }
+    if (detected.length > 0) {
+      console.log(chalk2.bold(`
+Detected project technologies:`));
+      for (const tech of detected) {
+        console.log(`  ${chalk2.cyan(tech)}`);
+      }
+    } else {
+      console.log(chalk2.dim(`
+No specific project dependencies detected`));
+    }
+    console.log(chalk2.bold(`
+Recommended skills (${recommended.length}):`));
+    for (const skill of recommended) {
+      console.log(`  ${chalk2.cyan(skill.name)} - ${skill.description}`);
+    }
+    console.log(chalk2.bold(`
+Installing recommended skills for ${options.for} (${options.scope})...
+`));
+    const installResults = [];
+    for (const skill of recommended) {
+      for (const agent of agents) {
+        const result = installSkillForAgent(skill.name, {
+          agent,
+          scope: options.scope
+        }, generateSkillMd);
+        installResults.push({ ...result, agent });
+        const label = `${skill.name} \u2192 ${agent} (${options.scope})`;
+        if (result.success) {
+          console.log(chalk2.green(`\u2713 ${label}`));
+        } else {
+          console.log(chalk2.red(`\u2717 ${label}: ${result.error}`));
+        }
+      }
+    }
+    if (installResults.some((r) => !r.success)) {
+      process.exitCode = 1;
+    }
+  }
   const installed = getInstalledSkills();
-  if (installed.length === 0) {
+  if (installed.length === 0 && !options.for) {
     if (options.json) {
       console.log(JSON.stringify({ skills: [], envVars: 0, gitignoreUpdated: false }));
     } else {
@@ -36639,6 +36874,8 @@ program2.command("init").option("--json", "Output as JSON", false).description("
     }
     return;
   }
+  if (installed.length === 0)
+    return;
   const envMap = new Map;
   for (const name of installed) {
     const reqs = getSkillRequirements(name);
@@ -36712,25 +36949,27 @@ ${gitignoreEntry}
       console.log(chalk2.dim("  .skills/ already in .gitignore"));
     }
   }
-  if (options.json) {
-    console.log(JSON.stringify({
-      skills: installed,
-      envVars: envVarCount,
-      gitignoreUpdated
-    }, null, 2));
-  } else {
-    if (envMap.size > 0) {
-      console.log(chalk2.bold(`
+  if (!options.for) {
+    if (options.json) {
+      console.log(JSON.stringify({
+        skills: installed,
+        envVars: envVarCount,
+        gitignoreUpdated
+      }, null, 2));
+    } else {
+      if (envMap.size > 0) {
+        console.log(chalk2.bold(`
 Skill environment requirements:`));
-      for (const name of installed) {
-        const reqs = getSkillRequirements(name);
-        if (reqs?.envVars.length) {
-          console.log(`  ${chalk2.cyan(name)}: ${reqs.envVars.join(", ")}`);
+        for (const name of installed) {
+          const reqs = getSkillRequirements(name);
+          if (reqs?.envVars.length) {
+            console.log(`  ${chalk2.cyan(name)}: ${reqs.envVars.join(", ")}`);
+          }
         }
       }
-    }
-    console.log(chalk2.bold(`
+      console.log(chalk2.bold(`
 Initialized for ${installed.length} installed skill(s)`));
+    }
   }
 });
 program2.command("remove").alias("rm").argument("<skill>", "Skill to remove").option("--json", "Output as JSON", false).option("--for <agent>", "Remove from agent: claude, codex, gemini, or all").option("--scope <scope>", "Remove scope: global or project", "global").option("--dry-run", "Print what would happen without actually removing", false).description("Remove an installed skill").action((skill, options) => {
@@ -36872,6 +37111,25 @@ Categories:
     console.log(`  ${name} (${count})`);
   }
 });
+program2.command("tags").option("--json", "Output as JSON", false).description("List all unique tags with counts").action((options) => {
+  const tagCounts = new Map;
+  for (const skill of SKILLS) {
+    for (const tag of skill.tags) {
+      tagCounts.set(tag, (tagCounts.get(tag) ?? 0) + 1);
+    }
+  }
+  const sorted = Array.from(tagCounts.entries()).sort(([a], [b]) => a.localeCompare(b)).map(([name, count]) => ({ name, count }));
+  if (options.json) {
+    console.log(JSON.stringify(sorted, null, 2));
+    return;
+  }
+  console.log(chalk2.bold(`
+Tags:
+`));
+  for (const { name, count } of sorted) {
+    console.log(`  ${chalk2.cyan(name)} (${count})`);
+  }
+});
 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];

package/bin/mcp.js

@@ -28599,7 +28599,7 @@ class StdioServerTransport {
 // package.json
 var package_default = {
   name: "@hasna/skills",
-  version: "0.1.5",
+  version: "0.1.6",
   description: "Skills library for AI coding agents",
   type: "module",
   bin: {
@@ -30113,6 +30113,45 @@ var SKILLS = [
 function getSkillsByCategory(category) {
   return SKILLS.filter((s) => s.category === category);
 }
+function editDistance(a, b) {
+  if (a === b)
+    return 0;
+  if (a.length === 0)
+    return b.length;
+  if (b.length === 0)
+    return a.length;
+  const prev = Array.from({ length: b.length + 1 }, (_, i) => i);
+  const curr = new Array(b.length + 1);
+  for (let i = 1;i <= a.length; i++) {
+    curr[0] = i;
+    for (let j = 1;j <= b.length; j++) {
+      const cost = a[i - 1] === b[j - 1] ? 0 : 1;
+      curr[j] = Math.min(curr[j - 1] + 1, prev[j] + 1, prev[j - 1] + cost);
+    }
+    prev.splice(0, prev.length, ...curr);
+  }
+  return prev[b.length];
+}
+function fuzzyMatchScore(word, target) {
+  if (target.includes(word))
+    return 1;
+  const tokens = target.split(/[\s\-_]+/).filter(Boolean);
+  for (const token of tokens) {
+    if (token.startsWith(word))
+      return 0.6;
+  }
+  if (word.length >= 3) {
+    const maxDist = word.length <= 3 ? 1 : 2;
+    for (const token of tokens) {
+      if (Math.abs(token.length - word.length) <= maxDist) {
+        const dist = editDistance(word, token);
+        if (dist <= maxDist)
+          return 0.4;
+      }
+    }
+  }
+  return 0;
+}
 function searchSkills(query) {
   const words = query.toLowerCase().split(/\s+/).filter(Boolean);
   if (words.length === 0)
@@ -30123,30 +30162,28 @@ function searchSkills(query) {
     const displayNameLower = skill.displayName.toLowerCase();
     const descriptionLower = skill.description.toLowerCase();
     const tagsLower = skill.tags.map((t) => t.toLowerCase());
+    const tagsCombined = tagsLower.join(" ");
     let score = 0;
     let allWordsMatch = true;
     for (const word of words) {
-      let wordMatched = false;
-      if (nameLower.includes(word)) {
-        score += 10;
-        wordMatched = true;
-      }
-      if (displayNameLower.includes(word)) {
-        score += 7;
-        wordMatched = true;
-      }
-      if (tagsLower.some((t) => t.includes(word))) {
-        score += 5;
-        wordMatched = true;
-      }
-      if (descriptionLower.includes(word)) {
-        score += 2;
-        wordMatched = true;
-      }
-      if (!wordMatched) {
+      let wordScore = 0;
+      const nameMatch = fuzzyMatchScore(word, nameLower);
+      if (nameMatch > 0)
+        wordScore += 10 * nameMatch;
+      const displayMatch = fuzzyMatchScore(word, displayNameLower);
+      if (displayMatch > 0)
+        wordScore += 7 * displayMatch;
+      const tagMatch = Math.max(...tagsLower.map((t) => fuzzyMatchScore(word, t)), fuzzyMatchScore(word, tagsCombined));
+      if (tagMatch > 0)
+        wordScore += 5 * tagMatch;
+      const descMatch = fuzzyMatchScore(word, descriptionLower);
+      if (descMatch > 0)
+        wordScore += 2 * descMatch;
+      if (wordScore === 0) {
         allWordsMatch = false;
         break;
       }
+      score += wordScore;
     }
     if (allWordsMatch && score > 0) {
       scored.push({ skill, score });
@@ -30709,6 +30746,19 @@ server.registerTool("list_categories", {
   }));
   return { content: [{ type: "text", text: JSON.stringify(cats, null, 2) }] };
 });
+server.registerTool("list_tags", {
+  title: "List Tags",
+  description: "List all unique tags across all skills with their occurrence counts"
+}, async () => {
+  const tagCounts = new Map;
+  for (const skill of SKILLS) {
+    for (const tag of skill.tags) {
+      tagCounts.set(tag, (tagCounts.get(tag) ?? 0) + 1);
+    }
+  }
+  const sorted = Array.from(tagCounts.entries()).sort(([a], [b]) => a.localeCompare(b)).map(([name, count]) => ({ name, count }));
+  return { content: [{ type: "text", text: JSON.stringify(sorted, null, 2) }] };
+});
 server.registerTool("get_requirements", {
   title: "Get Requirements",
   description: "Get environment variables, system dependencies, and npm dependencies for a skill",

package/dist/index.d.ts

@@ -7,6 +7,6 @@
  * Or use the interactive CLI:
  *   skills
  */
-export { SKILLS, CATEGORIES, getSkill, getSkillsByCategory, searchSkills, type SkillMeta, type Category, } from "./lib/registry.js";
+export { SKILLS, CATEGORIES, getSkill, getSkillsByCategory, searchSkills, getSkillsByTag, getAllTags, type SkillMeta, type Category, } from "./lib/registry.js";
 export { installSkill, installSkills, installSkillForAgent, removeSkillForAgent, getInstalledSkills, removeSkill, skillExists, getSkillPath, getAgentSkillsDir, getAgentSkillPath, AGENT_TARGETS, type InstallResult, type InstallOptions, type AgentTarget, type AgentScope, type AgentInstallOptions, } from "./lib/installer.js";
 export { getSkillDocs, getSkillBestDoc, getSkillRequirements, runSkill, generateEnvExample, generateSkillMd, type SkillDocs, type SkillRequirements, } from "./lib/skillinfo.js";

package/dist/index.js

@@ -1439,6 +1439,45 @@ var SKILLS = [
 function getSkillsByCategory(category) {
   return SKILLS.filter((s) => s.category === category);
 }
+function editDistance(a, b) {
+  if (a === b)
+    return 0;
+  if (a.length === 0)
+    return b.length;
+  if (b.length === 0)
+    return a.length;
+  const prev = Array.from({ length: b.length + 1 }, (_, i) => i);
+  const curr = new Array(b.length + 1);
+  for (let i = 1;i <= a.length; i++) {
+    curr[0] = i;
+    for (let j = 1;j <= b.length; j++) {
+      const cost = a[i - 1] === b[j - 1] ? 0 : 1;
+      curr[j] = Math.min(curr[j - 1] + 1, prev[j] + 1, prev[j - 1] + cost);
+    }
+    prev.splice(0, prev.length, ...curr);
+  }
+  return prev[b.length];
+}
+function fuzzyMatchScore(word, target) {
+  if (target.includes(word))
+    return 1;
+  const tokens = target.split(/[\s\-_]+/).filter(Boolean);
+  for (const token of tokens) {
+    if (token.startsWith(word))
+      return 0.6;
+  }
+  if (word.length >= 3) {
+    const maxDist = word.length <= 3 ? 1 : 2;
+    for (const token of tokens) {
+      if (Math.abs(token.length - word.length) <= maxDist) {
+        const dist = editDistance(word, token);
+        if (dist <= maxDist)
+          return 0.4;
+      }
+    }
+  }
+  return 0;
+}
 function searchSkills(query) {
   const words = query.toLowerCase().split(/\s+/).filter(Boolean);
   if (words.length === 0)
@@ -1449,30 +1488,28 @@ function searchSkills(query) {
     const displayNameLower = skill.displayName.toLowerCase();
     const descriptionLower = skill.description.toLowerCase();
     const tagsLower = skill.tags.map((t) => t.toLowerCase());
+    const tagsCombined = tagsLower.join(" ");
     let score = 0;
     let allWordsMatch = true;
     for (const word of words) {
-      let wordMatched = false;
-      if (nameLower.includes(word)) {
-        score += 10;
-        wordMatched = true;
-      }
-      if (displayNameLower.includes(word)) {
-        score += 7;
-        wordMatched = true;
-      }
-      if (tagsLower.some((t) => t.includes(word))) {
-        score += 5;
-        wordMatched = true;
-      }
-      if (descriptionLower.includes(word)) {
-        score += 2;
-        wordMatched = true;
-      }
-      if (!wordMatched) {
+      let wordScore = 0;
+      const nameMatch = fuzzyMatchScore(word, nameLower);
+      if (nameMatch > 0)
+        wordScore += 10 * nameMatch;
+      const displayMatch = fuzzyMatchScore(word, displayNameLower);
+      if (displayMatch > 0)
+        wordScore += 7 * displayMatch;
+      const tagMatch = Math.max(...tagsLower.map((t) => fuzzyMatchScore(word, t)), fuzzyMatchScore(word, tagsCombined));
+      if (tagMatch > 0)
+        wordScore += 5 * tagMatch;
+      const descMatch = fuzzyMatchScore(word, descriptionLower);
+      if (descMatch > 0)
+        wordScore += 2 * descMatch;
+      if (wordScore === 0) {
         allWordsMatch = false;
         break;
       }
+      score += wordScore;
     }
     if (allWordsMatch && score > 0) {
       scored.push({ skill, score });
@@ -1484,6 +1521,19 @@ function searchSkills(query) {
 function getSkill(name) {
   return SKILLS.find((s) => s.name === name);
 }
+function getSkillsByTag(tag) {
+  const needle = tag.toLowerCase();
+  return SKILLS.filter((s) => s.tags.some((t) => t.toLowerCase().includes(needle)));
+}
+function getAllTags() {
+  const tagSet = new Set;
+  for (const skill of SKILLS) {
+    for (const tag of skill.tags) {
+      tagSet.add(tag.toLowerCase());
+    }
+  }
+  return Array.from(tagSet).sort();
+}
 // src/lib/installer.ts
 import { existsSync, cpSync, mkdirSync, writeFileSync, rmSync, readdirSync, statSync, readFileSync } from "fs";
 import { join, dirname } from "path";
@@ -1957,6 +2007,7 @@ export {
   installSkills,
   installSkillForAgent,
   installSkill,
+  getSkillsByTag,
   getSkillsByCategory,
   getSkillRequirements,
   getSkillPath,
@@ -1964,6 +2015,7 @@ export {
   getSkillBestDoc,
   getSkill,
   getInstalledSkills,
+  getAllTags,
   getAgentSkillsDir,
   getAgentSkillPath,
   generateSkillMd,

package/dist/lib/registry.d.ts

@@ -15,3 +15,11 @@ export declare const SKILLS: SkillMeta[];
 export declare function getSkillsByCategory(category: Category): SkillMeta[];
 export declare function searchSkills(query: string): SkillMeta[];
 export declare function getSkill(name: string): SkillMeta | undefined;
+/**
+ * Return all skills whose tags include a partial case-insensitive match for `tag`.
+ */
+export declare function getSkillsByTag(tag: string): SkillMeta[];
+/**
+ * Return all unique tags across every skill, sorted alphabetically.
+ */
+export declare function getAllTags(): string[];

package/dist/lib/skillinfo.d.ts

@@ -1,6 +1,7 @@
 /**
  * Skill info - reads docs, requirements, and metadata from skill source
  */
+import { type SkillMeta } from "./registry.js";
 export interface SkillDocs {
     skillMd: string | null;
     readme: string | null;
@@ -33,6 +34,14 @@ export declare function runSkill(name: string, args: string[], options?: {
     exitCode: number;
     error?: string;
 }>;
+export interface DetectedProjectSkills {
+    detected: string[];
+    recommended: SkillMeta[];
+}
+/**
+ * Detect project type from package.json and recommend relevant skills
+ */
+export declare function detectProjectSkills(cwd?: string): DetectedProjectSkills;
 /**
  * Generate a .env.example from installed skills
  */

package/package.json

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