skill-library-mcp 1.3.4 → 2.0.0

package/.claude-plugin/hooks/hooks.json

@@ -0,0 +1,16 @@
+{
+  "hooks": {
+    "SessionStart": [
+      {
+        "matcher": "startup|resume|clear|compact",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "'${CLAUDE_PLUGIN_ROOT}/hooks/run-hook.cmd' session-start",
+            "async": false
+          }
+        ]
+      }
+    ]
+  }
+}

package/.claude-plugin/hooks/run-hook.cmd

@@ -0,0 +1,36 @@
+: << 'CMDBLOCK'
+@echo off
+REM Cross-platform polyglot wrapper for hook scripts.
+REM On Windows: cmd.exe runs the batch portion, which finds and calls bash.
+REM On Unix: the shell interprets this as a script (: is a no-op in bash).
+
+if "%~1"=="" (
+    echo run-hook.cmd: missing script name >&2
+    exit /b 1
+)
+
+set "HOOK_DIR=%~dp0"
+
+if exist "C:\Program Files\Git\bin\bash.exe" (
+    "C:\Program Files\Git\bin\bash.exe" "%HOOK_DIR%%~1" %2 %3 %4 %5 %6 %7 %8 %9
+    exit /b %ERRORLEVEL%
+)
+if exist "C:\Program Files (x86)\Git\bin\bash.exe" (
+    "C:\Program Files (x86)\Git\bin\bash.exe" "%HOOK_DIR%%~1" %2 %3 %4 %5 %6 %7 %8 %9
+    exit /b %ERRORLEVEL%
+)
+
+where bash >nul 2>nul
+if %ERRORLEVEL% equ 0 (
+    bash "%HOOK_DIR%%~1" %2 %3 %4 %5 %6 %7 %8 %9
+    exit /b %ERRORLEVEL%
+)
+
+exit /b 0
+CMDBLOCK
+
+# Unix: run the named script directly
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+SCRIPT_NAME="$1"
+shift
+exec bash "${SCRIPT_DIR}/${SCRIPT_NAME}" "$@"

package/.claude-plugin/hooks/session-start

@@ -0,0 +1,52 @@
+#!/usr/bin/env bash
+# SessionStart hook for skill-library plugin
+
+set -euo pipefail
+
+escape_for_json() {
+    local s="$1"
+    s="${s//\\/\\\\}"
+    s="${s//\"/\\\"}"
+    s="${s//$'\n'/\\n}"
+    s="${s//$'\r'/\\r}"
+    s="${s//$'\t'/\\t}"
+    printf '%s' "$s"
+}
+
+read -r -d '' CONTEXT << 'SKILLEOF' || true
+You have access to a skill library with 15,000+ skills via MCP tools.
+
+**IMPORTANT: Before responding to any task, check if a relevant skill exists.**
+
+Use these MCP tools from the skill-library server:
+- `search_skill({ query: "..." })` — Search for skills by keyword. Use natural language.
+- `load_skill({ name: "...", include_resources: true })` — Load the full skill content.
+- `list_categories()` — Browse all 13 skill categories.
+
+**When to search:**
+- Starting any new task (even simple ones — a skill may have best practices)
+- Working with a specific framework, library, or tool
+- Debugging, testing, deploying, or architecting
+- Any domain you're not 100% certain about
+
+**How to use:**
+1. Search with a short query related to your task
+2. If results look relevant, load the top skill
+3. Follow the skill's guidance in your response
+
+Don't skip this step. A 2-second search can prevent minutes of suboptimal work.
+SKILLEOF
+
+session_context="<IMPORTANT>\nYou have a skill library.\n\n$(escape_for_json "$CONTEXT")\n</IMPORTANT>"
+
+cat <<EOF
+{
+  "additional_context": "${session_context}",
+  "hookSpecificOutput": {
+    "hookEventName": "SessionStart",
+    "additionalContext": "${session_context}"
+  }
+}
+EOF
+
+exit 0

package/.claude-plugin/marketplace.json

@@ -1,14 +1,14 @@
 {
   "name": "skill-library-mcp",
   "version": "1.3.3",
-  "description": "On-demand access to 14,500+ curated skills for AI coding assistants via MCP",
+  "description": "On-demand access to 15,000+ curated skills for AI coding assistants via MCP",
   "owner": {
     "name": "modbender"
   },
   "plugins": [
     {
       "name": "skill-library",
-      "description": "On-demand access to 14,500+ curated skills for AI coding assistants. Search, browse categories, and load skills without polluting your context window.",
+      "description": "On-demand access to 15,000+ curated skills for AI coding assistants. Search, browse categories, and load skills without polluting your context window.",
       "source": "./",
       "category": "productivity",
       "keywords": ["skills", "mcp", "skill-library", "claude-code", "ai"]

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "skill-library",
-  "description": "On-demand access to 14,500+ curated skills for AI coding assistants. Search, browse categories, and load skills without polluting your context window.",
+  "description": "On-demand access to 15,000+ curated skills for AI coding assistants. Search, browse categories, and load skills without polluting your context window.",
   "version": "1.3.3",
   "author": {
     "name": "modbender"

package/README.md

@@ -1,16 +1,16 @@
 # Skill Library MCP
 
-**14,500+ ready-to-use skills for AI coding assistants, served on demand via MCP.**
+**15,000+ ready-to-use skills for AI coding assistants, served on demand via MCP.**
 
 [![npm version](https://img.shields.io/npm/v/skill-library-mcp)](https://www.npmjs.com/package/skill-library-mcp)
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
 [![Node.js](https://img.shields.io/badge/node-%3E%3D22-brightgreen)](https://nodejs.org)
 
-An MCP server that provides on-demand skill loading for AI coding assistants. Instead of stuffing your system prompt with every skill you might need, this server indexes 14,500+ skills and serves only the ones relevant to your current task — keeping context windows lean and responses focused.
+An MCP server that provides on-demand skill loading for AI coding assistants. Instead of stuffing your system prompt with every skill you might need, this server indexes 15,000+ skills and serves only the ones relevant to your current task — keeping context windows lean and responses focused.
 
 ## Why?
 
-- **14,500+ skills** covering frontend, backend, DevOps, security, testing, databases, AI/ML, automation, and more
+- **15,000+ skills** covering frontend, backend, DevOps, security, testing, databases, AI/ML, automation, and more
 - **On-demand loading** — skills are fetched only when needed, not crammed into every conversation
 - **IDF-weighted search** — finds the right skill even from natural language queries like "help me debug a memory leak"
 - **Browse by category** — 13 categories to discover skills you didn't know existed
@@ -22,61 +22,22 @@ An MCP server that provides on-demand skill loading for AI coding assistants. In
 
 ### Claude Code Plugin (Recommended)
 
-**CLI:**
-
-First, add the repository as a marketplace source, then install the plugin:
+Add the marketplace source, then install the plugin:
 
 ```bash
-claude plugin marketplace add https://github.com/modbender/skill-library-mcp.git
-claude plugin install skill-library
+claude plugin marketplace add https://github.com/modbender/skill-library-mcp.git --scope user
+claude plugin install skill-library --scope user
 ```
 
 The MCP server starts automatically when Claude Code launches. No manual configuration needed.
 
-To install for a specific scope:
-
-```bash
-claude plugin install skill-library --scope user      # Default, available everywhere
-claude plugin install skill-library --scope project   # Project-only, shared with collaborators
-```
-
-**Desktop UI:**
-
-1. Open Claude Desktop settings
-2. Go to **Plugins** and click **Add marketplace by URL**
-3. Enter the repository URL:
-   ```
-   https://github.com/modbender/skill-library-mcp.git
-   ```
-4. Install **skill-library** from the marketplace list
-
-**Local development:**
+### Claude Code (MCP Server)
 
 ```bash
-claude --plugin-dir /path/to/skill-library-mcp
+claude mcp add skill-library --scope user -- npx -y skill-library-mcp
 ```
 
-### MCP Server (Manual)
-
-For other tools or manual Claude Code setup, add to your MCP configuration:
-
-<details>
-<summary><strong>Claude Code (CLI)</strong></summary>
-
-Add to `~/.claude/settings.json`:
-
-```json
-{
-  "mcpServers": {
-    "skill-library": {
-      "command": "npx",
-      "args": ["-y", "skill-library-mcp"]
-    }
-  }
-}
-```
-
-</details>
+### MCP Server (Other Tools)
 
 <details>
 <summary><strong>Claude Desktop</strong></summary>
@@ -150,13 +111,6 @@ Add to `.vscode/mcp.json`:
 
 </details>
 
-<details>
-<summary><strong>Antigravity</strong></summary>
-
-See [Antigravity docs](https://docs.antigravity.dev) for MCP server configuration format.
-
-</details>
-
 <details>
 <summary><strong>Manual installation</strong></summary>
 
@@ -210,7 +164,7 @@ list_categories()
 
 ## Skill Categories
 
-The library includes 14,500+ skills across 13 categories:
+The library includes 15,000+ skills across 13 categories:
 
 | Category | Examples |
 |----------|----------|
@@ -249,7 +203,7 @@ Skills can optionally include a `resources/` directory with additional `.md` fil
 
 Contributions are welcome! To add a new skill:
 
-1. Create a directory under `skills/` with your skill name
+1. Create a directory under `data/` with your skill name
 2. Add a `SKILL.md` file with YAML frontmatter (`name`, `description`)
 3. Run `pnpm dedup` to check for duplicates
 4. Submit a PR
@@ -262,7 +216,7 @@ pnpm test             # Run tests
 pnpm build            # Build to dist/
 pnpm dev              # Run server locally
 pnpm dedup            # Check for duplicate skills
-pnpm validate-skills  # Validate skills/ directory structure
+pnpm validate-skills  # Validate data/ directory structure
 pnpm fix-skills       # Fix broken skills (dry run by default)
 pnpm clean-skills     # Remove invalid skill dirs (dry run by default)
 make ci               # Run test + validate + build

package/dist/index.js

@@ -201,26 +201,38 @@ function searchSkills(index, query, limit = 20) {
   for (const entry of index.entries) {
     let score = 0;
     let matchedTokens = 0;
+    const nameLower = entry.frontmatter.name.toLowerCase();
+    const descLower = entry.frontmatter.description.toLowerCase();
     for (const qt of queryTokens) {
       const idfWeight = index.idfScores.get(qt) ?? defaultIdf;
       let bestTokenScore = 0;
       for (const st of entry.searchTokens) {
         if (st === qt) {
           bestTokenScore = Math.max(bestTokenScore, idfWeight);
-        } else if (qt.length >= 2 && st.length >= 2 && (st.includes(qt) || qt.includes(st))) {
-          bestTokenScore = Math.max(bestTokenScore, idfWeight * 0.5);
+        } else if (qt.length >= 3 && st.length >= 3) {
+          if (st.includes(qt)) {
+            const overlap = qt.length / st.length;
+            bestTokenScore = Math.max(bestTokenScore, idfWeight * overlap * 0.5);
+          } else if (qt.includes(st)) {
+            const overlap = st.length / qt.length;
+            bestTokenScore = Math.max(bestTokenScore, idfWeight * overlap * 0.5);
+          }
         }
       }
       if (bestTokenScore > 0) matchedTokens++;
       score += bestTokenScore;
     }
-    if (entry.frontmatter.name.toLowerCase().includes(queryLower)) {
-      score += 2;
+    if (nameLower.includes(queryLower)) {
+      score += 3;
     }
-    if (entry.frontmatter.description.toLowerCase().includes(queryLower)) {
-      score += 1;
+    for (const qt of queryTokens) {
+      if (nameLower.includes(qt)) score += 1;
+    }
+    if (descLower.includes(queryLower)) {
+      score += 1.5;
     }
-    score = score / Math.max(matchedTokens, 1);
+    const coverage = matchedTokens / queryTokens.length;
+    score *= 1 + coverage;
     if (score >= 0.5) {
       results.push({
         name: entry.frontmatter.name,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "skill-library-mcp",
-  "version": "1.3.4",
+  "version": "2.0.0",
   "description": "MCP server providing on-demand skill loading for AI coding assistants",
   "license": "MIT",
   "type": "module",