progressive-skills-mcp 0.2.0__tar.gz → 0.2.1__tar.gz
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.
- {progressive_skills_mcp-0.2.0 → progressive_skills_mcp-0.2.1}/PKG-INFO +34 -52
- {progressive_skills_mcp-0.2.0 → progressive_skills_mcp-0.2.1}/README.md +33 -51
- {progressive_skills_mcp-0.2.0 → progressive_skills_mcp-0.2.1}/pyproject.toml +1 -1
- {progressive_skills_mcp-0.2.0 → progressive_skills_mcp-0.2.1}/src/progressive_skills_mcp/_version.py +1 -1
- {progressive_skills_mcp-0.2.0 → progressive_skills_mcp-0.2.1}/LICENSE +0 -0
- {progressive_skills_mcp-0.2.0 → progressive_skills_mcp-0.2.1}/src/progressive_skills_mcp/__init__.py +0 -0
- {progressive_skills_mcp-0.2.0 → progressive_skills_mcp-0.2.1}/src/progressive_skills_mcp/__main__.py +0 -0
- {progressive_skills_mcp-0.2.0 → progressive_skills_mcp-0.2.1}/src/progressive_skills_mcp/_server.py +0 -0
- {progressive_skills_mcp-0.2.0 → progressive_skills_mcp-0.2.1}/src/progressive_skills_mcp/progressive_disclosure.py +0 -0
- {progressive_skills_mcp-0.2.0 → progressive_skills_mcp-0.2.1}/src/progressive_skills_mcp/skills/context7-docs-lookup.zip +0 -0
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
Metadata-Version: 2.3
|
|
2
2
|
Name: progressive-skills-mcp
|
|
3
|
-
Version: 0.2.
|
|
3
|
+
Version: 0.2.1
|
|
4
4
|
Summary: MCP server that exposes Claude-style skills to any MCP client.
|
|
5
5
|
Keywords: mcp,skills,fastmcp,claude
|
|
6
6
|
Author: Eleanor Berger
|
|
@@ -39,7 +39,7 @@ Project-URL: Homepage, https://github.com/Flowtrica/skills-mcp
|
|
|
39
39
|
Project-URL: Issues, https://github.com/Flowtrica/skills-mcp/issues
|
|
40
40
|
Description-Content-Type: text/markdown
|
|
41
41
|
|
|
42
|
-
# Skills MCP
|
|
42
|
+
# Progressive Skills MCP
|
|
43
43
|
|
|
44
44
|
MCP server for SKILL.md files with **progressive disclosure** - achieving **13x token efficiency** over traditional approaches.
|
|
45
45
|
|
|
@@ -51,7 +51,7 @@ Based on [intellectronica/skillz](https://github.com/intellectronica/skillz) wit
|
|
|
51
51
|
- Creates 1 tool per skill
|
|
52
52
|
- 20 skills = 20 tools × ~100 tokens = **2000 tokens/request**
|
|
53
53
|
|
|
54
|
-
**Skills MCP
|
|
54
|
+
**Progressive Skills MCP:**
|
|
55
55
|
- Creates 3 universal tools (`load_skill`, `read_skill_file`, `list_skill_files`)
|
|
56
56
|
- 20 skills = 3 tools × ~50 tokens = **150 tokens/request**
|
|
57
57
|
- **13x improvement!** 🎉
|
|
@@ -62,23 +62,14 @@ Based on [intellectronica/skillz](https://github.com/intellectronica/skillz) wit
|
|
|
62
62
|
✅ Metadata generation for system prompts
|
|
63
63
|
✅ Compatible with all SKILL.md format files
|
|
64
64
|
✅ Supports .zip and .skill archives
|
|
65
|
-
✅
|
|
65
|
+
✅ Bundled skills ready to use
|
|
66
66
|
|
|
67
67
|
## Quick Start
|
|
68
68
|
|
|
69
|
-
### Using
|
|
69
|
+
### Using uvx (Recommended)
|
|
70
70
|
|
|
71
71
|
```bash
|
|
72
|
-
|
|
73
|
-
-v /path/to/skills:/skills \
|
|
74
|
-
flowtrica/skills-mcp:latest \
|
|
75
|
-
/skills
|
|
76
|
-
```
|
|
77
|
-
|
|
78
|
-
### Using uvx
|
|
79
|
-
|
|
80
|
-
```bash
|
|
81
|
-
uvx skills-mcp@latest /path/to/skills
|
|
72
|
+
uvx progressive-skills-mcp
|
|
82
73
|
```
|
|
83
74
|
|
|
84
75
|
### With MCPHub
|
|
@@ -87,19 +78,20 @@ uvx skills-mcp@latest /path/to/skills
|
|
|
87
78
|
{
|
|
88
79
|
"mcpServers": {
|
|
89
80
|
"skills": {
|
|
90
|
-
"command": "
|
|
91
|
-
"args": [
|
|
92
|
-
"run", "-i", "--rm",
|
|
93
|
-
"--entrypoint", "sh",
|
|
94
|
-
"flowtrica/skills-mcp:latest",
|
|
95
|
-
"-c",
|
|
96
|
-
"git clone https://github.com/YOUR_USERNAME/your-skills.git /tmp/skills && skills-mcp /tmp/skills"
|
|
97
|
-
]
|
|
81
|
+
"command": "uvx",
|
|
82
|
+
"args": ["progressive-skills-mcp"]
|
|
98
83
|
}
|
|
99
84
|
}
|
|
100
85
|
}
|
|
101
86
|
```
|
|
102
87
|
|
|
88
|
+
### Using pip
|
|
89
|
+
|
|
90
|
+
```bash
|
|
91
|
+
pip install progressive-skills-mcp
|
|
92
|
+
progressive-skills-mcp
|
|
93
|
+
```
|
|
94
|
+
|
|
103
95
|
## Progressive Disclosure
|
|
104
96
|
|
|
105
97
|
### Level 1: System Prompt (Once per conversation)
|
|
@@ -122,12 +114,18 @@ read_skill_file("pptx", "references/api.md")
|
|
|
122
114
|
```
|
|
123
115
|
**Cost:** 0 tokens until accessed
|
|
124
116
|
|
|
117
|
+
## Three Universal Tools
|
|
118
|
+
|
|
119
|
+
1. **`load_skill(skill_name)`** - Returns SKILL.md body without frontmatter
|
|
120
|
+
2. **`read_skill_file(skill_name, file_path)`** - Returns specific resource file
|
|
121
|
+
3. **`list_skill_files(skill_name, subdirectory?)`** - Lists available resources
|
|
122
|
+
|
|
125
123
|
## Generate Metadata
|
|
126
124
|
|
|
127
125
|
For Onyx or other MCP clients that support system prompts:
|
|
128
126
|
|
|
129
127
|
```bash
|
|
130
|
-
skills-mcp --generate-metadata
|
|
128
|
+
progressive-skills-mcp --generate-metadata
|
|
131
129
|
```
|
|
132
130
|
|
|
133
131
|
Output:
|
|
@@ -136,35 +134,26 @@ Output:
|
|
|
136
134
|
|
|
137
135
|
You have access to specialized skills...
|
|
138
136
|
|
|
139
|
-
- **
|
|
140
|
-
- **weather**: Get weather forecasts
|
|
141
|
-
```
|
|
142
|
-
|
|
143
|
-
## Installation
|
|
144
|
-
|
|
145
|
-
```bash
|
|
146
|
-
pip install skills-mcp
|
|
147
|
-
```
|
|
148
|
-
|
|
149
|
-
Or use with `uv`:
|
|
150
|
-
```bash
|
|
151
|
-
uv tool install skills-mcp
|
|
137
|
+
- **context7-docs-lookup**: Look up documentation from Context7
|
|
152
138
|
```
|
|
153
139
|
|
|
154
140
|
## Usage
|
|
155
141
|
|
|
156
142
|
```bash
|
|
157
|
-
# Run MCP server
|
|
158
|
-
skills-mcp
|
|
143
|
+
# Run MCP server with bundled skills
|
|
144
|
+
progressive-skills-mcp
|
|
145
|
+
|
|
146
|
+
# Run with custom skills directory
|
|
147
|
+
progressive-skills-mcp /path/to/skills
|
|
159
148
|
|
|
160
149
|
# Generate metadata
|
|
161
|
-
skills-mcp --generate-metadata
|
|
150
|
+
progressive-skills-mcp --generate-metadata
|
|
162
151
|
|
|
163
152
|
# Generate JSON metadata
|
|
164
|
-
skills-mcp --generate-metadata --format json
|
|
153
|
+
progressive-skills-mcp --generate-metadata --format json
|
|
165
154
|
|
|
166
155
|
# List discovered skills
|
|
167
|
-
skills-mcp --list-skills
|
|
156
|
+
progressive-skills-mcp --list-skills
|
|
168
157
|
```
|
|
169
158
|
|
|
170
159
|
## Skill Format
|
|
@@ -196,19 +185,12 @@ description: Brief description
|
|
|
196
185
|
Detailed skill instructions here...
|
|
197
186
|
```
|
|
198
187
|
|
|
199
|
-
## Building Docker Image
|
|
200
|
-
|
|
201
|
-
```bash
|
|
202
|
-
docker build -t flowtrica/skills-mcp:latest .
|
|
203
|
-
docker push flowtrica/skills-mcp:latest
|
|
204
|
-
```
|
|
205
|
-
|
|
206
188
|
## Token Efficiency Comparison
|
|
207
189
|
|
|
208
190
|
| Approach | Tools/Request | Tokens/Request | 20 Skills |
|
|
209
191
|
|----------|--------------|----------------|-----------|
|
|
210
192
|
| Original | 20 tools | ~100 each | 2000 tokens |
|
|
211
|
-
| **Skills MCP** | **3 tools** | **~50 each** | **150 tokens** |
|
|
193
|
+
| **Progressive Skills MCP** | **3 tools** | **~50 each** | **150 tokens** |
|
|
212
194
|
| **Improvement** | | | **13x better!** 🎉 |
|
|
213
195
|
|
|
214
196
|
## License
|
|
@@ -223,6 +205,6 @@ MIT (same as original skillz)
|
|
|
223
205
|
|
|
224
206
|
## Links
|
|
225
207
|
|
|
226
|
-
-
|
|
208
|
+
- GitHub: https://github.com/Flowtrica/skills-mcp
|
|
209
|
+
- PyPI: https://pypi.org/project/progressive-skills-mcp/
|
|
227
210
|
- Skills repo: https://github.com/Flowtrica/agent-skills
|
|
228
|
-
- Docker Hub: https://hub.docker.com/r/flowtrica/skills-mcp
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
# Skills MCP
|
|
1
|
+
# Progressive Skills MCP
|
|
2
2
|
|
|
3
3
|
MCP server for SKILL.md files with **progressive disclosure** - achieving **13x token efficiency** over traditional approaches.
|
|
4
4
|
|
|
@@ -10,7 +10,7 @@ Based on [intellectronica/skillz](https://github.com/intellectronica/skillz) wit
|
|
|
10
10
|
- Creates 1 tool per skill
|
|
11
11
|
- 20 skills = 20 tools × ~100 tokens = **2000 tokens/request**
|
|
12
12
|
|
|
13
|
-
**Skills MCP
|
|
13
|
+
**Progressive Skills MCP:**
|
|
14
14
|
- Creates 3 universal tools (`load_skill`, `read_skill_file`, `list_skill_files`)
|
|
15
15
|
- 20 skills = 3 tools × ~50 tokens = **150 tokens/request**
|
|
16
16
|
- **13x improvement!** 🎉
|
|
@@ -21,23 +21,14 @@ Based on [intellectronica/skillz](https://github.com/intellectronica/skillz) wit
|
|
|
21
21
|
✅ Metadata generation for system prompts
|
|
22
22
|
✅ Compatible with all SKILL.md format files
|
|
23
23
|
✅ Supports .zip and .skill archives
|
|
24
|
-
✅
|
|
24
|
+
✅ Bundled skills ready to use
|
|
25
25
|
|
|
26
26
|
## Quick Start
|
|
27
27
|
|
|
28
|
-
### Using
|
|
28
|
+
### Using uvx (Recommended)
|
|
29
29
|
|
|
30
30
|
```bash
|
|
31
|
-
|
|
32
|
-
-v /path/to/skills:/skills \
|
|
33
|
-
flowtrica/skills-mcp:latest \
|
|
34
|
-
/skills
|
|
35
|
-
```
|
|
36
|
-
|
|
37
|
-
### Using uvx
|
|
38
|
-
|
|
39
|
-
```bash
|
|
40
|
-
uvx skills-mcp@latest /path/to/skills
|
|
31
|
+
uvx progressive-skills-mcp
|
|
41
32
|
```
|
|
42
33
|
|
|
43
34
|
### With MCPHub
|
|
@@ -46,19 +37,20 @@ uvx skills-mcp@latest /path/to/skills
|
|
|
46
37
|
{
|
|
47
38
|
"mcpServers": {
|
|
48
39
|
"skills": {
|
|
49
|
-
"command": "
|
|
50
|
-
"args": [
|
|
51
|
-
"run", "-i", "--rm",
|
|
52
|
-
"--entrypoint", "sh",
|
|
53
|
-
"flowtrica/skills-mcp:latest",
|
|
54
|
-
"-c",
|
|
55
|
-
"git clone https://github.com/YOUR_USERNAME/your-skills.git /tmp/skills && skills-mcp /tmp/skills"
|
|
56
|
-
]
|
|
40
|
+
"command": "uvx",
|
|
41
|
+
"args": ["progressive-skills-mcp"]
|
|
57
42
|
}
|
|
58
43
|
}
|
|
59
44
|
}
|
|
60
45
|
```
|
|
61
46
|
|
|
47
|
+
### Using pip
|
|
48
|
+
|
|
49
|
+
```bash
|
|
50
|
+
pip install progressive-skills-mcp
|
|
51
|
+
progressive-skills-mcp
|
|
52
|
+
```
|
|
53
|
+
|
|
62
54
|
## Progressive Disclosure
|
|
63
55
|
|
|
64
56
|
### Level 1: System Prompt (Once per conversation)
|
|
@@ -81,12 +73,18 @@ read_skill_file("pptx", "references/api.md")
|
|
|
81
73
|
```
|
|
82
74
|
**Cost:** 0 tokens until accessed
|
|
83
75
|
|
|
76
|
+
## Three Universal Tools
|
|
77
|
+
|
|
78
|
+
1. **`load_skill(skill_name)`** - Returns SKILL.md body without frontmatter
|
|
79
|
+
2. **`read_skill_file(skill_name, file_path)`** - Returns specific resource file
|
|
80
|
+
3. **`list_skill_files(skill_name, subdirectory?)`** - Lists available resources
|
|
81
|
+
|
|
84
82
|
## Generate Metadata
|
|
85
83
|
|
|
86
84
|
For Onyx or other MCP clients that support system prompts:
|
|
87
85
|
|
|
88
86
|
```bash
|
|
89
|
-
skills-mcp --generate-metadata
|
|
87
|
+
progressive-skills-mcp --generate-metadata
|
|
90
88
|
```
|
|
91
89
|
|
|
92
90
|
Output:
|
|
@@ -95,35 +93,26 @@ Output:
|
|
|
95
93
|
|
|
96
94
|
You have access to specialized skills...
|
|
97
95
|
|
|
98
|
-
- **
|
|
99
|
-
- **weather**: Get weather forecasts
|
|
100
|
-
```
|
|
101
|
-
|
|
102
|
-
## Installation
|
|
103
|
-
|
|
104
|
-
```bash
|
|
105
|
-
pip install skills-mcp
|
|
106
|
-
```
|
|
107
|
-
|
|
108
|
-
Or use with `uv`:
|
|
109
|
-
```bash
|
|
110
|
-
uv tool install skills-mcp
|
|
96
|
+
- **context7-docs-lookup**: Look up documentation from Context7
|
|
111
97
|
```
|
|
112
98
|
|
|
113
99
|
## Usage
|
|
114
100
|
|
|
115
101
|
```bash
|
|
116
|
-
# Run MCP server
|
|
117
|
-
skills-mcp
|
|
102
|
+
# Run MCP server with bundled skills
|
|
103
|
+
progressive-skills-mcp
|
|
104
|
+
|
|
105
|
+
# Run with custom skills directory
|
|
106
|
+
progressive-skills-mcp /path/to/skills
|
|
118
107
|
|
|
119
108
|
# Generate metadata
|
|
120
|
-
skills-mcp --generate-metadata
|
|
109
|
+
progressive-skills-mcp --generate-metadata
|
|
121
110
|
|
|
122
111
|
# Generate JSON metadata
|
|
123
|
-
skills-mcp --generate-metadata --format json
|
|
112
|
+
progressive-skills-mcp --generate-metadata --format json
|
|
124
113
|
|
|
125
114
|
# List discovered skills
|
|
126
|
-
skills-mcp --list-skills
|
|
115
|
+
progressive-skills-mcp --list-skills
|
|
127
116
|
```
|
|
128
117
|
|
|
129
118
|
## Skill Format
|
|
@@ -155,19 +144,12 @@ description: Brief description
|
|
|
155
144
|
Detailed skill instructions here...
|
|
156
145
|
```
|
|
157
146
|
|
|
158
|
-
## Building Docker Image
|
|
159
|
-
|
|
160
|
-
```bash
|
|
161
|
-
docker build -t flowtrica/skills-mcp:latest .
|
|
162
|
-
docker push flowtrica/skills-mcp:latest
|
|
163
|
-
```
|
|
164
|
-
|
|
165
147
|
## Token Efficiency Comparison
|
|
166
148
|
|
|
167
149
|
| Approach | Tools/Request | Tokens/Request | 20 Skills |
|
|
168
150
|
|----------|--------------|----------------|-----------|
|
|
169
151
|
| Original | 20 tools | ~100 each | 2000 tokens |
|
|
170
|
-
| **Skills MCP** | **3 tools** | **~50 each** | **150 tokens** |
|
|
152
|
+
| **Progressive Skills MCP** | **3 tools** | **~50 each** | **150 tokens** |
|
|
171
153
|
| **Improvement** | | | **13x better!** 🎉 |
|
|
172
154
|
|
|
173
155
|
## License
|
|
@@ -182,6 +164,6 @@ MIT (same as original skillz)
|
|
|
182
164
|
|
|
183
165
|
## Links
|
|
184
166
|
|
|
185
|
-
-
|
|
167
|
+
- GitHub: https://github.com/Flowtrica/skills-mcp
|
|
168
|
+
- PyPI: https://pypi.org/project/progressive-skills-mcp/
|
|
186
169
|
- Skills repo: https://github.com/Flowtrica/agent-skills
|
|
187
|
-
- Docker Hub: https://hub.docker.com/r/flowtrica/skills-mcp
|
|
File without changes
|
{progressive_skills_mcp-0.2.0 → progressive_skills_mcp-0.2.1}/src/progressive_skills_mcp/__init__.py
RENAMED
|
File without changes
|
{progressive_skills_mcp-0.2.0 → progressive_skills_mcp-0.2.1}/src/progressive_skills_mcp/__main__.py
RENAMED
|
File without changes
|
{progressive_skills_mcp-0.2.0 → progressive_skills_mcp-0.2.1}/src/progressive_skills_mcp/_server.py
RENAMED
|
File without changes
|
|
File without changes
|