progressive-skills-mcp 0.2.0__py3-none-any.whl → 0.2.1__py3-none-any.whl
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/_version.py +1 -1
- {progressive_skills_mcp-0.2.0.dist-info → progressive_skills_mcp-0.2.1.dist-info}/METADATA +34 -52
- {progressive_skills_mcp-0.2.0.dist-info → progressive_skills_mcp-0.2.1.dist-info}/RECORD +5 -5
- {progressive_skills_mcp-0.2.0.dist-info → progressive_skills_mcp-0.2.1.dist-info}/WHEEL +0 -0
- {progressive_skills_mcp-0.2.0.dist-info → progressive_skills_mcp-0.2.1.dist-info}/entry_points.txt +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,10 +1,10 @@
|
|
|
1
1
|
progressive_skills_mcp/__init__.py,sha256=WFbujAfiFsm3g567Ea91ZXjhLesI78EVhc3Ao3oy1PM,522
|
|
2
2
|
progressive_skills_mcp/__main__.py,sha256=AFR1CXSuPL4Td1RPNWZzuUXntdaHqgJOp9DL5iPk8QM,215
|
|
3
3
|
progressive_skills_mcp/_server.py,sha256=jWuqHTTad8ECpawX-qd0PdNCodb0t2hcOPJo5qUnxVI,41991
|
|
4
|
-
progressive_skills_mcp/_version.py,sha256=
|
|
4
|
+
progressive_skills_mcp/_version.py,sha256=ukUDCV2XuFtENYt3V61bgrSLaGjZd72N96uSBKiR3-E,106
|
|
5
5
|
progressive_skills_mcp/progressive_disclosure.py,sha256=rSOGm0XodEXMoNlRTnkyPeDFiY3yug1i_pv3aUvHqPE,5855
|
|
6
6
|
progressive_skills_mcp/skills/context7-docs-lookup.zip,sha256=9jvk8QROayFq249BxCUCi2dhvaUdH2eOdEZunHjNSkg,2430
|
|
7
|
-
progressive_skills_mcp-0.2.
|
|
8
|
-
progressive_skills_mcp-0.2.
|
|
9
|
-
progressive_skills_mcp-0.2.
|
|
10
|
-
progressive_skills_mcp-0.2.
|
|
7
|
+
progressive_skills_mcp-0.2.1.dist-info/WHEEL,sha256=5DEXXimM34_d4Gx1AuF9ysMr1_maoEtGKjaILM3s4w4,80
|
|
8
|
+
progressive_skills_mcp-0.2.1.dist-info/entry_points.txt,sha256=v3yDRF-b-QfYLa8bfmOvTr40hHKTy9F0166K-DfoyGo,80
|
|
9
|
+
progressive_skills_mcp-0.2.1.dist-info/METADATA,sha256=iSfsMU2qqUMnUgfHjgJJERd9PhNzxsdAoChqW85nOnY,5831
|
|
10
|
+
progressive_skills_mcp-0.2.1.dist-info/RECORD,,
|
|
File without changes
|
{progressive_skills_mcp-0.2.0.dist-info → progressive_skills_mcp-0.2.1.dist-info}/entry_points.txt
RENAMED
|
File without changes
|