progressive-skills-mcp

# Progressive Skills MCP MCP server for SKILL.md files with **progressive disclosure** - achieving **13x token efficiency** over traditional MCP approaches. Based on [intellectronica/skillz](https://github.com/intellectronica/skillz) with progressive disclosure modifications inspired by Claude.ai's skills system. ## Why Progressive Disclosure? Many MCP servers load all their information upfront - every tool description, parameter, and instruction is included in each request. This consumes significant tokens even when most information isn't needed. **Traditional MCP Approach:** - Creates 1 tool per skill/capability - All tool descriptions sent with every request - 20 skills = 20 tools × ~100 tokens = **~2000 tokens/request** - Information sent whether needed or not **Progressive Skills MCP:** - Creates 3 universal tools that load skills on-demand - Only skill names/descriptions sent initially - Full instructions loaded only when needed - 20 skills = 3 tools × ~50 tokens + skill list = **~150 tokens/request** - **13x more efficient!** 🎉 **The Three Levels:** 1. **System Prompt**: Brief skill list (~200 tokens, sent once) 2. **On-Demand Loading**: Full skill instructions (0 tokens until requested) 3. **Referenced Resources**: Additional files (0 tokens until accessed) This approach is especially valuable when working with many skills or limited context windows. ## Features ✅ Progressive disclosure (3-level token efficiency) ✅ Compatible with all SKILL.md format files ✅ Supports .zip and .skill archives ✅ Flexible skills source (local directories, VPS volumes) ✅ Simple `uvx` installation - works with any MCP client ## Installation **Important:** Before installing, you must create a skills directory and optionally add some skills to it. The server will not start without a valid skills directory. ### Setup Steps **Step 1: Create Your Skills Directory** Choose where to store your skills: **Local (Linux/Mac):** ```bash mkdir -p ~/.skills # Or any…