progressive-skills-mcp 0.2.0__tar.gz

progressive_skills_mcp-0.2.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Eleanor Berger <eleanor@intellectronica.net>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

progressive_skills_mcp-0.2.0/PKG-INFO

@@ -0,0 +1,228 @@
+Metadata-Version: 2.3
+Name: progressive-skills-mcp
+Version: 0.2.0
+Summary: MCP server that exposes Claude-style skills to any MCP client.
+Keywords: mcp,skills,fastmcp,claude
+Author: Eleanor Berger
+Author-email: Eleanor Berger <eleanor@intellectronica.net>
+License: MIT License
+         
+         Copyright (c) 2025 Eleanor Berger <eleanor@intellectronica.net>
+         
+         Permission is hereby granted, free of charge, to any person obtaining a copy
+         of this software and associated documentation files (the "Software"), to deal
+         in the Software without restriction, including without limitation the rights
+         to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+         copies of the Software, and to permit persons to whom the Software is
+         furnished to do so, subject to the following conditions:
+         
+         The above copyright notice and this permission notice shall be included in all
+         copies or substantial portions of the Software.
+         
+         THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+         IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+         FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+         AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+         LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+         OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+         SOFTWARE.
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Requires-Dist: fastmcp>=2.2.5
+Requires-Dist: pyyaml>=6.0
+Requires-Python: >=3.12
+Project-URL: Homepage, https://github.com/Flowtrica/skills-mcp
+Project-URL: Issues, https://github.com/Flowtrica/skills-mcp/issues
+Description-Content-Type: text/markdown
+
+# Skills MCP
+
+MCP server for SKILL.md files with **progressive disclosure** - achieving **13x token efficiency** over traditional approaches.
+
+Based on [intellectronica/skillz](https://github.com/intellectronica/skillz) with progressive disclosure modifications inspired by Claude.ai's approach.
+
+## What's Different?
+
+**Original skillz:**
+- Creates 1 tool per skill
+- 20 skills = 20 tools × ~100 tokens = **2000 tokens/request**
+
+**Skills MCP (this fork):**
+- Creates 3 universal tools (`load_skill`, `read_skill_file`, `list_skill_files`)
+- 20 skills = 3 tools × ~50 tokens = **150 tokens/request**
+- **13x improvement!** 🎉
+
+## Features
+
+✅ Progressive disclosure (3-level token efficiency)  
+✅ Metadata generation for system prompts  
+✅ Compatible with all SKILL.md format files  
+✅ Supports .zip and .skill archives  
+✅ Docker image available  
+
+## Quick Start
+
+### Using Docker
+
+```bash
+docker run -i --rm \
+  -v /path/to/skills:/skills \
+  flowtrica/skills-mcp:latest \
+  /skills
+```
+
+### Using uvx
+
+```bash
+uvx skills-mcp@latest /path/to/skills
+```
+
+### With MCPHub
+
+```json
+{
+  "mcpServers": {
+    "skills": {
+      "command": "docker",
+      "args": [
+        "run", "-i", "--rm",
+        "--entrypoint", "sh",
+        "flowtrica/skills-mcp:latest",
+        "-c",
+        "git clone https://github.com/YOUR_USERNAME/your-skills.git /tmp/skills && skills-mcp /tmp/skills"
+      ]
+    }
+  }
+}
+```
+
+## Progressive Disclosure
+
+### Level 1: System Prompt (Once per conversation)
+```markdown
+## Available Skills
+- **weather**: Get weather forecasts
+- **pptx**: Create presentations
+```
+**Cost:** ~200 tokens, sent ONCE
+
+### Level 2: On-Demand Instructions
+```python
+load_skill("pptx")  # Returns full SKILL.md
+```
+**Cost:** 0 tokens until loaded
+
+### Level 3: Referenced Resources  
+```python
+read_skill_file("pptx", "references/api.md")
+```
+**Cost:** 0 tokens until accessed
+
+## Generate Metadata
+
+For Onyx or other MCP clients that support system prompts:
+
+```bash
+skills-mcp --generate-metadata /path/to/skills
+```
+
+Output:
+```markdown
+## Available Skills
+
+You have access to specialized skills...
+
+- **test-skill**: A simple test skill
+- **weather**: Get weather forecasts
+```
+
+## Installation
+
+```bash
+pip install skills-mcp
+```
+
+Or use with `uv`:
+```bash
+uv tool install skills-mcp
+```
+
+## Usage
+
+```bash
+# Run MCP server
+skills-mcp /path/to/skills
+
+# Generate metadata
+skills-mcp --generate-metadata /path/to/skills
+
+# Generate JSON metadata
+skills-mcp --generate-metadata --format json /path/to/skills
+
+# List discovered skills
+skills-mcp --list-skills /path/to/skills
+```
+
+## Skill Format
+
+Skills can be:
+- **Directories** with SKILL.md file
+- **Zip archives** containing SKILL.md
+- **.skill archives**
+
+Example structure:
+```
+skills/
+├── weather/
+│   ├── SKILL.md
+│   └── references/
+│       └── api.md
+└── pptx.zip
+```
+
+SKILL.md format:
+```markdown
+---
+name: skill-name
+description: Brief description
+---
+
+# Full Instructions
+
+Detailed skill instructions here...
+```
+
+## Building Docker Image
+
+```bash
+docker build -t flowtrica/skills-mcp:latest .
+docker push flowtrica/skills-mcp:latest
+```
+
+## Token Efficiency Comparison
+
+| Approach | Tools/Request | Tokens/Request | 20 Skills |
+|----------|--------------|----------------|-----------|
+| Original | 20 tools | ~100 each | 2000 tokens |
+| **Skills MCP** | **3 tools** | **~50 each** | **150 tokens** |
+| **Improvement** | | | **13x better!** 🎉 |
+
+## License
+
+MIT (same as original skillz)
+
+## Credits
+
+- Based on [skillz](https://github.com/intellectronica/skillz) by Eleanor Berger
+- Progressive disclosure modifications by Flowtrica
+- Inspired by Claude.ai's skills system
+
+## Links
+
+- Original skillz: https://github.com/intellectronica/skillz
+- Skills repo: https://github.com/Flowtrica/agent-skills
+- Docker Hub: https://hub.docker.com/r/flowtrica/skills-mcp

progressive_skills_mcp-0.2.0/README.md

@@ -0,0 +1,187 @@
+# Skills MCP
+
+MCP server for SKILL.md files with **progressive disclosure** - achieving **13x token efficiency** over traditional approaches.
+
+Based on [intellectronica/skillz](https://github.com/intellectronica/skillz) with progressive disclosure modifications inspired by Claude.ai's approach.
+
+## What's Different?
+
+**Original skillz:**
+- Creates 1 tool per skill
+- 20 skills = 20 tools × ~100 tokens = **2000 tokens/request**
+
+**Skills MCP (this fork):**
+- Creates 3 universal tools (`load_skill`, `read_skill_file`, `list_skill_files`)
+- 20 skills = 3 tools × ~50 tokens = **150 tokens/request**
+- **13x improvement!** 🎉
+
+## Features
+
+✅ Progressive disclosure (3-level token efficiency)  
+✅ Metadata generation for system prompts  
+✅ Compatible with all SKILL.md format files  
+✅ Supports .zip and .skill archives  
+✅ Docker image available  
+
+## Quick Start
+
+### Using Docker
+
+```bash
+docker run -i --rm \
+  -v /path/to/skills:/skills \
+  flowtrica/skills-mcp:latest \
+  /skills
+```
+
+### Using uvx
+
+```bash
+uvx skills-mcp@latest /path/to/skills
+```
+
+### With MCPHub
+
+```json
+{
+  "mcpServers": {
+    "skills": {
+      "command": "docker",
+      "args": [
+        "run", "-i", "--rm",
+        "--entrypoint", "sh",
+        "flowtrica/skills-mcp:latest",
+        "-c",
+        "git clone https://github.com/YOUR_USERNAME/your-skills.git /tmp/skills && skills-mcp /tmp/skills"
+      ]
+    }
+  }
+}
+```
+
+## Progressive Disclosure
+
+### Level 1: System Prompt (Once per conversation)
+```markdown
+## Available Skills
+- **weather**: Get weather forecasts
+- **pptx**: Create presentations
+```
+**Cost:** ~200 tokens, sent ONCE
+
+### Level 2: On-Demand Instructions
+```python
+load_skill("pptx")  # Returns full SKILL.md
+```
+**Cost:** 0 tokens until loaded
+
+### Level 3: Referenced Resources  
+```python
+read_skill_file("pptx", "references/api.md")
+```
+**Cost:** 0 tokens until accessed
+
+## Generate Metadata
+
+For Onyx or other MCP clients that support system prompts:
+
+```bash
+skills-mcp --generate-metadata /path/to/skills
+```
+
+Output:
+```markdown
+## Available Skills
+
+You have access to specialized skills...
+
+- **test-skill**: A simple test skill
+- **weather**: Get weather forecasts
+```
+
+## Installation
+
+```bash
+pip install skills-mcp
+```
+
+Or use with `uv`:
+```bash
+uv tool install skills-mcp
+```
+
+## Usage
+
+```bash
+# Run MCP server
+skills-mcp /path/to/skills
+
+# Generate metadata
+skills-mcp --generate-metadata /path/to/skills
+
+# Generate JSON metadata
+skills-mcp --generate-metadata --format json /path/to/skills
+
+# List discovered skills
+skills-mcp --list-skills /path/to/skills
+```
+
+## Skill Format
+
+Skills can be:
+- **Directories** with SKILL.md file
+- **Zip archives** containing SKILL.md
+- **.skill archives**
+
+Example structure:
+```
+skills/
+├── weather/
+│   ├── SKILL.md
+│   └── references/
+│       └── api.md
+└── pptx.zip
+```
+
+SKILL.md format:
+```markdown
+---
+name: skill-name
+description: Brief description
+---
+
+# Full Instructions
+
+Detailed skill instructions here...
+```
+
+## Building Docker Image
+
+```bash
+docker build -t flowtrica/skills-mcp:latest .
+docker push flowtrica/skills-mcp:latest
+```
+
+## Token Efficiency Comparison
+
+| Approach | Tools/Request | Tokens/Request | 20 Skills |
+|----------|--------------|----------------|-----------|
+| Original | 20 tools | ~100 each | 2000 tokens |
+| **Skills MCP** | **3 tools** | **~50 each** | **150 tokens** |
+| **Improvement** | | | **13x better!** 🎉 |
+
+## License
+
+MIT (same as original skillz)
+
+## Credits
+
+- Based on [skillz](https://github.com/intellectronica/skillz) by Eleanor Berger
+- Progressive disclosure modifications by Flowtrica
+- Inspired by Claude.ai's skills system
+
+## Links
+
+- Original skillz: https://github.com/intellectronica/skillz
+- Skills repo: https://github.com/Flowtrica/agent-skills
+- Docker Hub: https://hub.docker.com/r/flowtrica/skills-mcp

progressive_skills_mcp-0.2.0/pyproject.toml

@@ -0,0 +1,52 @@
+[project]
+name = "progressive-skills-mcp"
+version = "0.2.0"
+description = "MCP server that exposes Claude-style skills to any MCP client."
+readme = "README.md"
+authors = [
+    { name = "Eleanor Berger", email = "eleanor@intellectronica.net" }
+]
+requires-python = ">=3.12"
+dependencies = [
+    "fastmcp>=2.2.5",
+    "pyyaml>=6.0",
+]
+license = { file = "LICENSE" }
+keywords = ["mcp", "skills", "fastmcp", "claude"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.12",
+]
+
+[project.urls]
+Homepage = "https://github.com/Flowtrica/skills-mcp"
+Issues = "https://github.com/Flowtrica/skills-mcp/issues"
+
+[project.scripts]
+progressive-skills-mcp = "progressive_skills_mcp.__main__:run"
+
+[build-system]
+requires = ["uv_build>=0.9.5,<0.10.0"]
+build-backend = "uv_build"
+
+[dependency-groups]
+dev = [
+    "pytest>=8.4.2",
+    "pytest-asyncio>=0.23.7",
+    "ruff>=0.6.9",
+]
+
+[tool.uv]
+package = true
+default-groups = ["dev"]
+
+[tool.ruff]
+line-length = 79
+target-version = "py312"
+
+[tool.ruff.lint]
+select = ["E", "W", "F"]

progressive_skills_mcp-0.2.0/src/progressive_skills_mcp/__init__.py

@@ -0,0 +1,29 @@
+"""Public package interface for the Skillz MCP server."""
+
+from ._version import __version__
+from ._server import (
+    Skill,
+    SkillError,
+    SkillMetadata,
+    SkillRegistry,
+    SkillValidationError,
+    build_server,
+    configure_logging,
+    list_skills,
+    main,
+    parse_args,
+)
+
+__all__ = [
+    "Skill",
+    "SkillError",
+    "SkillMetadata",
+    "SkillRegistry",
+    "SkillValidationError",
+    "build_server",
+    "configure_logging",
+    "list_skills",
+    "main",
+    "parse_args",
+    "__version__",
+]

progressive_skills_mcp-0.2.0/src/progressive_skills_mcp/__main__.py

@@ -0,0 +1,13 @@
+"""Console script entry point for the Skillz MCP server."""
+
+from ._server import main
+
+
+def run() -> None:
+    """Execute the CLI using the stored entry point."""
+
+    main()
+
+
+if __name__ == "__main__":
+    run()