skill-library-mcp 1.3.5 → 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/README.md

@@ -25,16 +25,16 @@ An MCP server that provides on-demand skill loading for AI coding assistants. In
 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.
 
-### Claude Code (CLI)
+### Claude Code (MCP Server)
 
 ```bash
-claude mcp add skill-library -- npx -y skill-library-mcp
+claude mcp add skill-library --scope user -- npx -y skill-library-mcp
 ```
 
 ### MCP Server (Other Tools)

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.5",
+  "version": "2.0.0",
   "description": "MCP server providing on-demand skill loading for AI coding assistants",
   "license": "MIT",
   "type": "module",