progressive-skills-mcp 0.2.1__py3-none-any.whl → 0.2.2__py3-none-any.whl

progressive_skills_mcp/_version.py

@@ -2,4 +2,4 @@
 
 __all__ = ["__version__"]
 
-__version__ = "0.2.1"
+__version__ = "0.2.2"

{progressive_skills_mcp-0.2.1.dist-info → progressive_skills_mcp-0.2.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: progressive-skills-mcp
-Version: 0.2.1
+Version: 0.2.2
 Summary: MCP server that exposes Claude-style skills to any MCP client.
 Keywords: mcp,skills,fastmcp,claude
 Author: Eleanor Berger
@@ -92,25 +92,92 @@ pip install progressive-skills-mcp
 progressive-skills-mcp
 ```
 
+## System Prompt Configuration
+
+Progressive disclosure works by adding skill metadata to your LLM agent's system prompt. This tells the agent what skills are available **without** loading all the detailed instructions.
+
+### Step 1: Generate Metadata
+
+```bash
+progressive-skills-mcp --generate-metadata > skills-metadata.txt
+```
+
+This outputs:
+
+```markdown
+## Available Skills
+
+You have access to specialized skills that provide detailed instructions for specific tasks. When a task requires specialized knowledge or a specific workflow, use the `load_skill` tool to get the full instructions.
+
+### How to Use Skills
+
+1. Check if a skill is relevant to the user's request
+2. Call `load_skill("skill-name")` to get detailed instructions
+3. Follow the instructions in the skill
+4. Use `read_skill_file()` if the skill references additional resources
+
+**Available skills:**
+
+- **context7-docs-lookup**: Look up documentation from Context7 for libraries and frameworks
+```
+
+### Step 2: Add to Agent System Prompt
+
+Copy the metadata output and add it to your LLM agent's system prompt. For example, in **Onyx**, **LibreChat**, or **Open WebUI**:
+
+```
+You are a helpful AI assistant.
+
+[... other system prompt content ...]
+
+## Available Skills
+
+You have access to specialized skills that provide detailed instructions for specific tasks...
+
+- **context7-docs-lookup**: Look up documentation from Context7...
+```
+
+### Step 3: Agent Uses Skills
+
+When relevant, the agent will:
+
+1. **See skill in system prompt** → "context7-docs-lookup is available"
+2. **Call load_skill** → `load_skill("context7-docs-lookup")`
+3. **Receive full instructions** → Complete SKILL.md content
+4. **Follow instructions** → Execute the skill workflow
+
+### Example Conversation
+
+**User:** "How do I use React hooks in Next.js?"
+
+**Agent thinks:** *The context7-docs-lookup skill can help with documentation lookup*
+
+**Agent calls:** `load_skill("context7-docs-lookup")`
+
+**Agent receives:** Full skill instructions on how to use Context7 API
+
+**Agent executes:** Follows skill instructions to look up Next.js documentation
+
+**Agent responds:** "Here's how to use React hooks in Next.js..." (with accurate docs)
+
 ## Progressive Disclosure
 
 ### Level 1: System Prompt (Once per conversation)
 ```markdown
 ## Available Skills
-- **weather**: Get weather forecasts
-- **pptx**: Create presentations
+- **context7-docs-lookup**: Look up documentation
 ```
 **Cost:** ~200 tokens, sent ONCE
 
 ### Level 2: On-Demand Instructions
 ```python
-load_skill("pptx")  # Returns full SKILL.md
+load_skill("context7-docs-lookup")  # Returns full SKILL.md
 ```
 **Cost:** 0 tokens until loaded
 
 ### Level 3: Referenced Resources  
 ```python
-read_skill_file("pptx", "references/api.md")
+read_skill_file("context7-docs-lookup", "references/api.md")
 ```
 **Cost:** 0 tokens until accessed
 
@@ -125,16 +192,22 @@ read_skill_file("pptx", "references/api.md")
 For Onyx or other MCP clients that support system prompts:
 
 ```bash
+# Markdown format (default)
 progressive-skills-mcp --generate-metadata
-```
 
-Output:
-```markdown
-## Available Skills
-
-You have access to specialized skills...
+# JSON format
+progressive-skills-mcp --generate-metadata --format json
+```
 
-- **context7-docs-lookup**: Look up documentation from Context7
+JSON output:
+```json
+[
+  {
+    "name": "context7-docs-lookup",
+    "description": "Look up documentation from Context7 for libraries and frameworks",
+    "allowed_tools": []
+  }
+]
 ```
 
 ## Usage

{progressive_skills_mcp-0.2.1.dist-info → progressive_skills_mcp-0.2.2.dist-info}/RECORD

@@ -1,10 +1,10 @@
 progressive_skills_mcp/__init__.py,sha256=WFbujAfiFsm3g567Ea91ZXjhLesI78EVhc3Ao3oy1PM,522
 progressive_skills_mcp/__main__.py,sha256=AFR1CXSuPL4Td1RPNWZzuUXntdaHqgJOp9DL5iPk8QM,215
 progressive_skills_mcp/_server.py,sha256=jWuqHTTad8ECpawX-qd0PdNCodb0t2hcOPJo5qUnxVI,41991
-progressive_skills_mcp/_version.py,sha256=ukUDCV2XuFtENYt3V61bgrSLaGjZd72N96uSBKiR3-E,106
+progressive_skills_mcp/_version.py,sha256=aRZvnn0d3cT0nCnucc8oQ7KxmH8nEH65UHo0SQmxtNE,106
 progressive_skills_mcp/progressive_disclosure.py,sha256=rSOGm0XodEXMoNlRTnkyPeDFiY3yug1i_pv3aUvHqPE,5855
 progressive_skills_mcp/skills/context7-docs-lookup.zip,sha256=9jvk8QROayFq249BxCUCi2dhvaUdH2eOdEZunHjNSkg,2430
-progressive_skills_mcp-0.2.1.dist-info/WHEEL,sha256=5DEXXimM34_d4Gx1AuF9ysMr1_maoEtGKjaILM3s4w4,80
-progressive_skills_mcp-0.2.1.dist-info/entry_points.txt,sha256=v3yDRF-b-QfYLa8bfmOvTr40hHKTy9F0166K-DfoyGo,80
-progressive_skills_mcp-0.2.1.dist-info/METADATA,sha256=iSfsMU2qqUMnUgfHjgJJERd9PhNzxsdAoChqW85nOnY,5831
-progressive_skills_mcp-0.2.1.dist-info/RECORD,,
+progressive_skills_mcp-0.2.2.dist-info/WHEEL,sha256=5DEXXimM34_d4Gx1AuF9ysMr1_maoEtGKjaILM3s4w4,80
+progressive_skills_mcp-0.2.2.dist-info/entry_points.txt,sha256=v3yDRF-b-QfYLa8bfmOvTr40hHKTy9F0166K-DfoyGo,80
+progressive_skills_mcp-0.2.2.dist-info/METADATA,sha256=5ihcmxPu5093uyJ8OFXIXZ8fcHaGdUewV2_dNo6Mu_o,8164
+progressive_skills_mcp-0.2.2.dist-info/RECORD,,