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.
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.3
2
2
  Name: progressive-skills-mcp
3
- Version: 0.2.0
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 (this fork):**
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
- Docker image available
65
+ Bundled skills ready to use
66
66
 
67
67
  ## Quick Start
68
68
 
69
- ### Using Docker
69
+ ### Using uvx (Recommended)
70
70
 
71
71
  ```bash
72
- docker run -i --rm \
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": "docker",
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 /path/to/skills
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
- - **test-skill**: A simple test skill
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 /path/to/skills
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 /path/to/skills
150
+ progressive-skills-mcp --generate-metadata
162
151
 
163
152
  # Generate JSON metadata
164
- skills-mcp --generate-metadata --format json /path/to/skills
153
+ progressive-skills-mcp --generate-metadata --format json
165
154
 
166
155
  # List discovered skills
167
- skills-mcp --list-skills /path/to/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
- - Original skillz: https://github.com/intellectronica/skillz
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 (this fork):**
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
- Docker image available
24
+ Bundled skills ready to use
25
25
 
26
26
  ## Quick Start
27
27
 
28
- ### Using Docker
28
+ ### Using uvx (Recommended)
29
29
 
30
30
  ```bash
31
- docker run -i --rm \
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": "docker",
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 /path/to/skills
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
- - **test-skill**: A simple test skill
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 /path/to/skills
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 /path/to/skills
109
+ progressive-skills-mcp --generate-metadata
121
110
 
122
111
  # Generate JSON metadata
123
- skills-mcp --generate-metadata --format json /path/to/skills
112
+ progressive-skills-mcp --generate-metadata --format json
124
113
 
125
114
  # List discovered skills
126
- skills-mcp --list-skills /path/to/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
- - Original skillz: https://github.com/intellectronica/skillz
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
@@ -1,6 +1,6 @@
1
1
  [project]
2
2
  name = "progressive-skills-mcp"
3
- version = "0.2.0"
3
+ version = "0.2.1"
4
4
  description = "MCP server that exposes Claude-style skills to any MCP client."
5
5
  readme = "README.md"
6
6
  authors = [
@@ -2,4 +2,4 @@
2
2
 
3
3
  __all__ = ["__version__"]
4
4
 
5
- __version__ = "0.2.0"
5
+ __version__ = "0.2.1"