@skillsmith/mcp-server 0.3.18 → 0.3.20

package/README.md

@@ -1,18 +1,25 @@
 # @skillsmith/mcp-server
 
+MCP (Model Context Protocol) server for agent skill discovery, installation, and management.
+
+## What's New in v0.3.18
+
+- **Async Initialization** (SMI-2205): Server initializes asynchronously for faster startup
+- **WASM Fallback** (SMI-2206): Automatic fallback to sql.js when native SQLite unavailable
+- **Robust Context Loading** (SMI-2207): Graceful handling of initialization edge cases
+- **612 tests passing** with comprehensive coverage
+
 ## Auto-Update Notifications
 
 The MCP server checks for updates on startup and notifies you when a newer version is available:
 
 ```
-[skillsmith] Update available: 0.3.15 → 0.3.16
-Restart Claude Code to use the latest version.
+[skillsmith] Update available: 0.3.17 → 0.3.18
+Restart your MCP client to use the latest version.
 ```
 
 To disable update checks, set `SKILLSMITH_AUTO_UPDATE_CHECK=false` in your environment.
 
-MCP (Model Context Protocol) server for Claude Code skill discovery, installation, and management.
-
 ## Installation
 
 ```bash
@@ -21,7 +28,7 @@ npm install @skillsmith/mcp-server
 
 ## Quick Start
 
-Copy this snippet and paste it into Claude Code:
+Copy this MCP configuration snippet:
 
 ```
 Add this MCP server to my settings.json:
@@ -36,7 +43,7 @@ Add this MCP server to my settings.json:
 }
 ```
 
-Claude will automatically update your `~/.claude/settings.json`. After restarting Claude Code (Cmd/Ctrl+Shift+P → "Claude Code: Restart"), ask Claude:
+After adding to your MCP client settings and restarting, try asking:
 
 ```
 "Search for testing skills"
@@ -88,7 +95,7 @@ Without an API key, you're limited to **10 total requests** (trial mode). With a
 }
 ```
 
-**Step 3:** Restart Claude Code (Cmd/Ctrl+Shift+P → "Claude Code: Restart")
+**Step 3:** Restart your MCP client
 
 > **Security Note:** Never paste your API key in chat. Configure it via the settings file above. For testing, set the env var using the appropriate command for your platform:
 >
@@ -161,7 +168,7 @@ Get detailed information about a specific skill.
 
 ### install_skill
 
-Install a skill to your local Claude Code environment.
+Install a skill to your local environment.
 
 | Parameter | Type | Required | Description |
 |-----------|------|----------|-------------|
@@ -204,7 +211,7 @@ Compare multiple skills side-by-side.
 
 | Tier | Description |
 |------|-------------|
-| `verified` | Official Anthropic skills |
+| `verified` | Official platform skills |
 | `community` | Community-reviewed skills |
 | `experimental` | New/beta skills |
 | `unknown` | Unverified skills |
@@ -215,8 +222,19 @@ Compare multiple skills side-by-side.
 |----------|-------------|---------|
 | `SKILLSMITH_DB_PATH` | Database file location | `~/.skillsmith/skills.db` |
 | `SKILLSMITH_TELEMETRY_ENABLED` | Enable anonymous telemetry | `false` |
+| `SKILLSMITH_USE_WASM` | Force WASM SQLite driver (sql.js) | `false` |
 | `POSTHOG_API_KEY` | PostHog API key (required if telemetry enabled) | - |
 
+### WASM Fallback (v0.3.18+)
+
+The MCP server automatically falls back to a WASM-based SQLite driver (sql.js) when native better-sqlite3 is unavailable. This ensures the server works in environments where native modules can't be compiled.
+
+The fallback is automatic—no configuration needed. To force WASM mode:
+
+```bash
+export SKILLSMITH_USE_WASM=true
+```
+
 ## Telemetry
 
 Skillsmith includes optional, anonymous telemetry to help improve the product. **Telemetry is disabled by default.**