@hasna/skills 0.1.5 → 0.1.7

package/README.md

@@ -10,7 +10,7 @@ npx @hasna/skills
 
 - **202 ready-to-use skills** across development, business, content, data, media, design, and more
 - **Interactive TUI** -- browse by category, search, and install from the terminal
-- **MCP server** -- 9 tools and 2 resources for AI agent integration
+- **MCP server** -- 10 tools and 2 resources for AI agent integration
 - **HTTP dashboard** -- React web UI to browse, search, install, and manage skills
 - **Agent-aware installs** -- copies SKILL.md to `~/.claude/skills/`, `~/.codex/skills/`, or `~/.gemini/skills/`
 - **Auto-generated index** -- `.skills/index.ts` is updated on every install for easy imports
@@ -52,6 +52,12 @@ skills run image --prompt "a sunset over mountains"
 
 # Start the web dashboard
 skills serve
+
+# Smart init: detect project type and install skills for Claude
+skills init --for claude
+
+# Browse skills by tag
+skills list --tags api,testing
 ```
 
 ## Categories
@@ -84,23 +90,24 @@ skills serve
 | `skills install <names...>` | `skills add` | Install one or more skills to `.skills/` |
 | `skills install <name> --for <agent>` | | Install SKILL.md for claude, codex, gemini, or all |
 | `skills remove <name>` | `skills rm` | Remove an installed skill |
-| `skills list` | `skills ls` | List all available skills |
+| `skills list` | `skills ls` | List all available skills (supports `--tags` to filter by tags) |
 | `skills list --category <cat>` | | List skills in a category |
 | `skills list --installed` | | List installed skills |
-| `skills search <query>` | | Search skills by name, description, or tags |
+| `skills search <query>` | | Search skills by name, description, or tags (supports `--tags` to filter by tags) |
 | `skills info <name>` | | Show skill metadata, requirements, and env vars |
 | `skills docs <name>` | | Show skill documentation (SKILL.md/README.md/CLAUDE.md) |
 | `skills requires <name>` | | Show env vars, system deps, and npm dependencies |
 | `skills run <name> [args...]` | | Run a skill directly |
 | `skills categories` | | List all categories with counts |
-| `skills init` | | Generate `.env.example` and update `.gitignore` |
+| `skills tags` | | List all tags with skill counts |
+| `skills init` | | Initialize project, detect deps, and optionally install for agents |
 | `skills update [names...]` | | Update installed skills (reinstall with overwrite) |
 | `skills serve` | | Start the HTTP dashboard (auto-assigns free port) |
 | `skills mcp` | | Start the MCP server on stdio |
 | `skills mcp --register <agent>` | | Register MCP server with claude, codex, gemini, or all |
 | `skills self-update` | | Update `@hasna/skills` to the latest version |
 
-All list/search/info commands support `--json` for machine-readable output.
+All list/search/info commands support `--json` for machine-readable output. Search uses fuzzy matching -- typos and abbreviations are tolerated.
 
 ## MCP Server
 
@@ -133,7 +140,7 @@ Add to your MCP config:
 }
 ```
 
-### Tools (9)
+### Tools (10)
 
 | Tool | Description |
 |------|-------------|
@@ -144,6 +151,7 @@ Add to your MCP config:
 | `install_skill` | Install a skill (full source to `.skills/` or SKILL.md to agent dir) |
 | `remove_skill` | Remove an installed skill |
 | `list_categories` | List all categories with skill counts |
+| `list_tags` | List all skill tags with counts |
 | `get_requirements` | Get env vars, system deps, and npm dependencies |
 | `run_skill` | Run a skill by name with optional arguments |
 
@@ -190,6 +198,7 @@ The dashboard server also exposes a REST API:
 | `/api/skills/:name/docs` | GET | Raw documentation text |
 | `/api/skills/:name/install` | POST | Install a skill |
 | `/api/skills/:name/remove` | POST | Remove a skill |
+| `/api/tags` | GET | All tags with skill counts |
 | `/api/version` | GET | Current package version |
 | `/api/self-update` | POST | Update to latest version |
 

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.7",
     description: "Skills library for AI coding agents",
     type: "module",
     bin: {
@@ -1919,6 +1919,12 @@ var init_package = __esm(() => {
       "typescript",
       "bun",
       "claude",
+      "codex",
+      "gemini",
+      "mcp",
+      "model-context-protocol",
+      "open-source",
+      "skill-library",
       "automation"
     ],
     author: "Hasna",
@@ -1957,6 +1963,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 +2012,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 +5438,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 +34926,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 +35102,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())
@@ -36316,15 +36469,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(`Non-interactive environment detected. Use a subcommand:
-`);
-    console.log("  skills list          List available skills");
-    console.log("  skills search <q>    Search skills");
-    console.log("  skills install <n>   Install a skill");
-    console.log("  skills info <n>      Show skill details");
-    console.log("  skills serve         Start web dashboard");
-    console.log(`  skills --help        Show all commands
-`);
+    console.log(JSON.stringify(SKILLS, null, 2));
     process.exit(0);
   }
   render(/* @__PURE__ */ jsxDEV7(App, {}, undefined, false, undefined, this));
@@ -36416,7 +36561,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 +36580,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 +36589,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 +36605,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 +36635,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 +36647,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 +36795,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 +36872,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 +36947,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 +37109,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];
@@ -36953,12 +37209,14 @@ program2.command("completion").argument("<shell>", "Shell type: bash, zsh, or fi
     "remove",
     "update",
     "categories",
+    "tags",
     "mcp",
     "serve",
     "init",
     "self-update",
     "completion",
-    "outdated"
+    "outdated",
+    "doctor"
   ];
   const skillNames = SKILLS.map((s) => s.name);
   const categoryNames = CATEGORIES.map((c) => c);

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.7",
   description: "Skills library for AI coding agents",
   type: "module",
   bin: {
@@ -28640,6 +28640,12 @@ var package_default = {
     "typescript",
     "bun",
     "claude",
+    "codex",
+    "gemini",
+    "mcp",
+    "model-context-protocol",
+    "open-source",
+    "skill-library",
     "automation"
   ],
   author: "Hasna",
@@ -30113,6 +30119,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 +30168,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 +30752,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.7",
   "description": "Skills library for AI coding agents",
   "type": "module",
   "bin": {
@@ -41,6 +41,12 @@
     "typescript",
     "bun",
     "claude",
+    "codex",
+    "gemini",
+    "mcp",
+    "model-context-protocol",
+    "open-source",
+    "skill-library",
     "automation"
   ],
   "author": "Hasna",