skillmds 0.1.0 → 0.1.1
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 +99 -0
- package/package.json +18 -4
package/README.md
ADDED
|
@@ -0,0 +1,99 @@
|
|
|
1
|
+
# skillmds
|
|
2
|
+
|
|
3
|
+
[](https://www.npmjs.com/package/skillmds)
|
|
4
|
+
[](https://www.npmjs.com/package/skillmds)
|
|
5
|
+
[](#license)
|
|
6
|
+
|
|
7
|
+
> The official MCP server for **[SkillMD](https://skillmd.com)** — the open, verified registry of Agent Skills.
|
|
8
|
+
|
|
9
|
+
Search, fetch, and install Agent Skills (`SKILL.md` files) from one open library, straight inside any MCP-capable agent — Claude Code, Claude Desktop, Cursor, and more. No copy-paste, no manual downloads.
|
|
10
|
+
|
|
11
|
+
---
|
|
12
|
+
|
|
13
|
+
## Install
|
|
14
|
+
|
|
15
|
+
**Claude Code** (one line):
|
|
16
|
+
|
|
17
|
+
```bash
|
|
18
|
+
claude mcp add skillmds -- npx -y skillmds
|
|
19
|
+
```
|
|
20
|
+
|
|
21
|
+
**Claude Desktop / Cursor / any MCP client** — add to your MCP config:
|
|
22
|
+
|
|
23
|
+
```jsonc
|
|
24
|
+
{
|
|
25
|
+
"mcpServers": {
|
|
26
|
+
"skillmds": {
|
|
27
|
+
"command": "npx",
|
|
28
|
+
"args": ["-y", "skillmds"]
|
|
29
|
+
}
|
|
30
|
+
}
|
|
31
|
+
}
|
|
32
|
+
```
|
|
33
|
+
|
|
34
|
+
That's it. Restart your client and the SkillMD tools are available.
|
|
35
|
+
|
|
36
|
+
---
|
|
37
|
+
|
|
38
|
+
## What you can do
|
|
39
|
+
|
|
40
|
+
Once connected, just ask your agent in plain language:
|
|
41
|
+
|
|
42
|
+
- *"Find a skill for optimizing Dockerfiles."*
|
|
43
|
+
- *"Install the anthropic/pdf skill."*
|
|
44
|
+
- *"What are the top-rated data skills right now?"*
|
|
45
|
+
|
|
46
|
+
The agent picks the right tool, fetches the skill from SkillMD, and writes it into your skills directory.
|
|
47
|
+
|
|
48
|
+
## Tools
|
|
49
|
+
|
|
50
|
+
| Tool | Auth | What it does |
|
|
51
|
+
| --- | --- | --- |
|
|
52
|
+
| `skillmd_search` | – | Search skills by name, description, or task (filter by category, type, rating, verified). |
|
|
53
|
+
| `skillmd_get` | – | Fetch one skill by `owner/name`, with its `SKILL.md`, provenance, license, and security flags. |
|
|
54
|
+
| `skillmd_install` | – | Write a skill's `SKILL.md` into your agent's skills dir. **Never executes scripts.** |
|
|
55
|
+
| `skillmd_trending` | – | Top skills on the leaderboard (`30d` or `all`, optional category). |
|
|
56
|
+
| `skillmd_recommend` | – | Skills similar to one you give, or trending if none. |
|
|
57
|
+
| `skillmd_list_saved` | token | Your saved skills (requires `SKILLMD_TOKEN`). |
|
|
58
|
+
|
|
59
|
+
By default, `skillmd_install` writes to `~/.claude/skills/<name>/SKILL.md`. Pass a `dest` to target another directory.
|
|
60
|
+
|
|
61
|
+
## Configuration
|
|
62
|
+
|
|
63
|
+
Both are optional environment variables:
|
|
64
|
+
|
|
65
|
+
| Variable | Default | Purpose |
|
|
66
|
+
| --- | --- | --- |
|
|
67
|
+
| `SKILLMD_API` | `https://skillmd-api.vinoor.workers.dev` | Override the API base URL. |
|
|
68
|
+
| `SKILLMD_TOKEN` | – | SkillMD personal access token; enables `skillmd_list_saved` and personalized recommendations. |
|
|
69
|
+
|
|
70
|
+
Example with a token:
|
|
71
|
+
|
|
72
|
+
```jsonc
|
|
73
|
+
{
|
|
74
|
+
"mcpServers": {
|
|
75
|
+
"skillmds": {
|
|
76
|
+
"command": "npx",
|
|
77
|
+
"args": ["-y", "skillmds"],
|
|
78
|
+
"env": { "SKILLMD_TOKEN": "skillmd_pat_…" }
|
|
79
|
+
}
|
|
80
|
+
}
|
|
81
|
+
}
|
|
82
|
+
```
|
|
83
|
+
|
|
84
|
+
## Safety
|
|
85
|
+
|
|
86
|
+
SkillMD shows security flags (executes scripts, network calls, reads secrets, or docs-only) parsed from every skill's files, and **this server never runs a skill's scripts** — `skillmd_install` only writes the `SKILL.md` to disk. Review a skill before relying on it, especially from unverified authors.
|
|
87
|
+
|
|
88
|
+
## Requirements
|
|
89
|
+
|
|
90
|
+
- Node.js **18+**
|
|
91
|
+
|
|
92
|
+
## Links
|
|
93
|
+
|
|
94
|
+
- 🌐 Registry: **[skillmd.com](https://skillmd.com)**
|
|
95
|
+
- 🧩 What is an Agent Skill? See the [FAQ](https://skillmd.com/#faq)
|
|
96
|
+
|
|
97
|
+
## License
|
|
98
|
+
|
|
99
|
+
MIT
|
package/package.json
CHANGED
|
@@ -1,14 +1,28 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "skillmds",
|
|
3
|
-
"version": "0.1.
|
|
4
|
-
"description": "
|
|
3
|
+
"version": "0.1.1",
|
|
4
|
+
"description": "Official MCP server for SkillMD — search, fetch, and install Agent Skills (SKILL.md) from skillmd.com inside any MCP-capable agent.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"bin": {
|
|
7
7
|
"skillmds": "bin/skillmd-mcp.mjs"
|
|
8
8
|
},
|
|
9
|
-
"keywords": [
|
|
9
|
+
"keywords": [
|
|
10
|
+
"mcp",
|
|
11
|
+
"model-context-protocol",
|
|
12
|
+
"agent-skills",
|
|
13
|
+
"skill.md",
|
|
14
|
+
"skillmd",
|
|
15
|
+
"claude",
|
|
16
|
+
"claude-code",
|
|
17
|
+
"cursor",
|
|
18
|
+
"ai-agents",
|
|
19
|
+
"llm"
|
|
20
|
+
],
|
|
10
21
|
"homepage": "https://skillmd.com",
|
|
11
|
-
"
|
|
22
|
+
"bugs": { "url": "https://skillmd.com/contact" },
|
|
23
|
+
"author": "SkillMD",
|
|
24
|
+
"license": "MIT",
|
|
25
|
+
"files": ["bin", "README.md"],
|
|
12
26
|
"engines": { "node": ">=18" },
|
|
13
27
|
"dependencies": {
|
|
14
28
|
"@modelcontextprotocol/sdk": "^1.13.0"
|