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.
@@ -2,4 +2,4 @@
2
2
 
3
3
  __all__ = ["__version__"]
4
4
 
5
- __version__ = "0.2.0"
5
+ __version__ = "0.2.1"
@@ -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,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=q4q6xy8hoU3hhiPLlZPK9YPK0gwpSwNYBznw8EVjY6k,106
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.0.dist-info/WHEEL,sha256=5DEXXimM34_d4Gx1AuF9ysMr1_maoEtGKjaILM3s4w4,80
8
- progressive_skills_mcp-0.2.0.dist-info/entry_points.txt,sha256=v3yDRF-b-QfYLa8bfmOvTr40hHKTy9F0166K-DfoyGo,80
9
- progressive_skills_mcp-0.2.0.dist-info/METADATA,sha256=yirmfD0v-RsW7xn-bIWfFB4ABcZt94TMX88AxxT26es,5964
10
- progressive_skills_mcp-0.2.0.dist-info/RECORD,,
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,,