@skillsmith/mcp-server 0.3.10 → 0.3.12

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -36,15 +36,32 @@ Claude will automatically update your `~/.claude/settings.json`. After restartin
36
36
 
37
37
  ## Live Skill Registry
38
38
 
39
- Version 0.3.8 includes the live skill registry with 14,000+ skills.
39
+ The Skillsmith API provides access to **14,000+ skills** that are:
40
40
 
41
- > **Note (v0.3.8):** Fixed critical bug where the MCP server defaulted to offline mode for all users. Search now correctly connects to the production API. See [SMI-1948](https://linear.app/smith-horn-group/issue/SMI-1948).
41
+ - **Indexed daily** from GitHub repositories
42
+ - **Security screened hourly** for vulnerabilities and malicious patterns
43
+ - **Quality scored** based on documentation, structure, and community feedback
44
+ - **Categorized** by trust tier (Verified, Community, Experimental)
42
45
 
43
46
  Skills are served from `api.skillsmith.app` and cached locally for 24 hours.
44
47
 
48
+ > **Note (v0.3.8):** Fixed critical bug where the MCP server defaulted to offline mode for all users. Search now correctly connects to the production API. See [SMI-1948](https://linear.app/smith-horn-group/issue/SMI-1948).
49
+
50
+ ### Why Configure an API Key?
51
+
52
+ Without an API key, you're limited to **10 total requests** (trial mode). With a free Community account, you get **30 requests/minute** with access to all live skills.
53
+
54
+ **Benefits of API key:**
55
+ - Access to live indexed skills (not just cached)
56
+ - Higher rate limits based on your tier
57
+ - Usage tracking on your dashboard
58
+ - Priority during high-traffic periods
59
+
45
60
  ### API Key Configuration (SMI-1953)
46
61
 
47
- For usage tracking and higher rate limits, configure your personal API key:
62
+ **Step 1:** Get your API key from https://skillsmith.app/account
63
+
64
+ **Step 2:** Add to your Claude settings at `~/.claude/settings.json`:
48
65
 
49
66
  ```json
50
67
  {
@@ -60,13 +77,32 @@ For usage tracking and higher rate limits, configure your personal API key:
60
77
  }
61
78
  ```
62
79
 
63
- Get your API key from https://skillsmith.app/account after signing up.
64
-
65
- | Auth Mode | Rate Limit | Usage Tracking |
66
- |-----------|------------|----------------|
67
- | Personal API Key | Tier-based (60-300/min) | Dashboard |
68
- | Anonymous (default) | 30/min | ❌ Not tracked |
69
- | No auth | 10 total | Trial only |
80
+ **Step 3:** Restart Claude Code (Cmd/Ctrl+Shift+P "Claude Code: Restart")
81
+
82
+ > **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:
83
+ >
84
+ > | Platform | Command |
85
+ > |----------|---------|
86
+ > | Mac/Linux | `!export SKILLSMITH_API_KEY='your-key-here'` |
87
+ > | Windows PowerShell | `!$env:SKILLSMITH_API_KEY='your-key-here'` |
88
+ > | Windows CMD | `!set SKILLSMITH_API_KEY=your-key-here` |
89
+ >
90
+ > The `!` prefix in Claude Code runs the command without exposing the output. See [SMI-1956](https://linear.app/smith-horn-group/issue/SMI-1956).
91
+
92
+ ### Rate Limits by Tier
93
+
94
+ | Tier | Rate Limit | Monthly Cost | Best For |
95
+ |------|------------|--------------|----------|
96
+ | Trial | 10 total | Free | Quick evaluation |
97
+ | Community | 30/min | Free | Personal projects |
98
+ | Individual | 60/min | $9.99/mo | Active developers |
99
+ | Team | 120/min | $25/user/mo | Development teams |
100
+ | Enterprise | 300/min | $55/user/mo | Large organizations |
101
+
102
+ All tiers include:
103
+ - Full access to skill search, details, and recommendations
104
+ - Security screening results
105
+ - Quality scores and trust tier information
70
106
 
71
107
  ### API Configuration
72
108