Skills Registry MCP Server

# Skills Registry MCP - Quick Start Guide ## 🚀 Get Running in 5 Minutes ### 1. Extract and Setup ```bash tar -xzf skills-registry-mcp.tar.gz cd skills-registry-mcp # Add your OpenAI API key for semantic search cp .env.example .env # Edit with your preferred editor (vi, code, notepad, etc.) # Or just add it directly: echo "OPENAI_API_KEY=sk-your-key-here" >> .env ``` ### 2. Start Docker Services ```bash docker-compose up -d # Watch logs (optional) docker-compose logs -f mcp-server ``` ### 3. Import Skills from GitHub ```bash # This imports 60+ skills from multiple repos ./scripts/import_github_skills.sh ``` **What gets imported:** - ✅ Official Anthropic skills (docx, pdf, pptx, xlsx, etc.) - ✅ Obra's Superpowers collection (40+ dev workflow skills) - ✅ Composio community skills - ✅ Other popular community skills **Import takes:** ~2-3 minutes depending on network speed ### 4. Connect with NCP ```bash # Install NCP if you haven't npm install -g @portel/ncp # Add the Skills Registry MCP ncp add skills http://localhost:8000 # Test it ncp find "pdf extraction" ``` ### 5. Use with Claude In Claude Desktop: 1. Settings > Connectors 2. Add custom connector: `http://localhost:8000` 3. Enable the connector Now Claude can search and use skills automatically! ## 📊 Verify Everything Works ```bash # Check how many skills imported docker-compose exec postgres psql -U skills -d skills_registry \ -c "SELECT COUNT(*), category FROM skills GROUP BY category;" # Check trending (should show recently imported) docker-compose exec mcp-server python -c " import asyncio from src.database import Database import os db = Database(os.getenv('DATABASE_URL')) async def check(): trending = await db.get_trending(5, 'day') for skill in trending: print(f\"- {skill['name']} ({skill['usage_count']} uses)\") asyncio.run(check()) " ``` ## 🎯 Example Queries for Claude Once connected, try asking Claude: **Document Skills:** - "Find skills for creating professional presentations" - "Show me PDF extraction skills" - "What skills help with Excel spreadsheets?" **Development Skills:** - "Find test-driven development skills" - "Show me Git workflow skills" - "What debugging skills are available?" **Design Skills:** - "Find skills for creating generative art" - "Show me design theme skills" **Using Skills:** - "Use the docx skill to create a report" - "Load the pdf-master skill and extract this form" - "Apply the theme-factory skill to style this presentation" ## 🔧 Troubleshooting ### Services won't start ```bash # Check what's running docker-compose ps # View logs docker-compose logs # Restart everything docker-compose down && docker-compose up -d ``` ### Import fails ```bash # Check you have git installed git --version # Check OpenAI key is set docker-compose exec mcp-server env | grep OPENAI # Re-run import with verbose output docker-compose exec mcp-server python scripts/import_skills.py ``` ### NCP can't connect ```bash # Check MCP server is accessible curl http://localhost:8000/health # Check NCP config ncp config view # Remove and re-add ncp remove skills ncp add skills http://localhost:8000 ``` ## 📈 What's Next? ### Add Your Own Skills ```python # Use the skill_upload tool via Claude or NCP { "name": "My Custom Skill", "description": "Does something awesome", "skill_md_content": "# My Skill\n\n...", "category": "custom", "tags": ["custom", "awesome"], "author_id": "your-username", "visibility": "private" } ``` ### Rate & Favorite Skills ```python # Rate a skill skill_rate(skill_id="docx-master", user_id="you", rating=5) # Add to favorites skill_favorite_add(skill_id="docx-master", user_id="you") # View favorites skill_favorite_list(user_id="you") ``` ### Browse Categories ```python # See all categories skill_list_categories() # Search by category skill_search(query="", category="documents", limit=20) ``` ## 🌐 Going Production ### Cloud Hosting (Future) Replace localhost URLs with your deployed server: ```bash ncp add skills https://your-skills-registry.com ``` ### Team Sharing Share your `.env` and `docker-compose.yml` with team members. Everyone gets the same skills registry! ### Backup Database ```bash # Backup docker-compose exec postgres pg_dump -U skills skills_registry > backup.sql # Restore docker-compose exec -T postgres psql -U skills skills_registry < backup.sql ``` ## 💡 Tips 1. **Semantic Search Quality**: Better API embeddings = better search results 2. **Custom Skills**: Start with template-skill from Anthropic as a base 3. **Trending Skills**: Usage is tracked automatically - popular skills surface naturally 4. **Private Skills**: Set `visibility="private"` for personal/team-only skills 5. **Skill Versions**: Use naming like "skill-name-v2" for major updates ## 🆘 Need Help? - Check logs: `docker-compose logs mcp-server` - Database status: `docker-compose exec postgres psql -U skills -d skills_registry -c '\dt'` - Skill count: `SELECT COUNT(*) FROM skills;` - Clear and restart: `docker-compose down -v && docker-compose up -d` --- **You're all set! Start using Claude with the full skills ecosystem.** 🎉