skillsmp-search
Scannednpx machina-cli add skill Lu1sDV/skillsmd/skillsmp-search --openclawSkillsMP Search & Installer
Search 11,000+ community skills and install them locally.
When to Use
- User asks to find/search/install a skill
- User needs a capability that likely exists as a community skill
Not for: Project-specific conventions (CLAUDE.md), already-installed skills.
API Config
- Base:
https://skillsmp.com/api/v1/skills - Key:
cat ~/.claude/skills/skillsmp-search/.skillsmp-key - Auth:
Authorization: Bearer <key>| Limit: 500/day
Search
Keyword (fast, ~500ms) - specific terms, sort by stars:
curl -s "https://skillsmp.com/api/v1/skills/search?q=QUERY&limit=30&sortBy=stars" \
-H "Authorization: Bearer $(cat ~/.claude/skills/skillsmp-search/.skillsmp-key)"
Response: data.skills[] → id, name, author, description, githubUrl, stars, updatedAt
AI Semantic (smart, ~5s) - natural language, conceptual queries:
curl -s "https://skillsmp.com/api/v1/skills/ai-search?q=QUERY" \
-H "Authorization: Bearer $(cat ~/.claude/skills/skillsmp-search/.skillsmp-key)"
Response: data.data[] → score (0-1) + skill object. Skip entries with skill: null.
| Query type | Mode |
|---|---|
| Specific tech ("react testing") | Keyword, sortBy=stars |
| Natural language / vague | AI semantic |
| "newest", "latest", "recent skills" | Keyword, sortBy=recent |
Fall back to keyword if AI returns few results.
Present & Choose
Show ALL found skills in the ranked table — never truncate or omit results. Then use AskUserQuestion to let user pick - never auto-select.
Always include a "Compare to find best" option in addition to numbered skill choices:
| # | Skill | Author | Stars | Description |
|---|-------|--------|-------|-------------|
| 1 | name | @author | 42 | ... |
Include relevance score for AI results.
AskUserQuestion options: numbered skills + "Compare to find best"
Compare to find best
When user selects "Compare to find best":
- Gather criteria: Ask user to expand needs/priorities (optional - they may just confirm)
- Load standards: Read
external/anthropic-skills-best-practices.mdfor the quality checklist - Fetch & evaluate: Download SKILL.md from top candidates, score each against:
- Description quality & trigger specificity
- Conciseness & token efficiency
- Progressive disclosure structure
- Workflow clarity & feedback loops
- Code quality (if applicable)
- Present comparison: Show strengths/weaknesses table for each candidate
- Final decision: Use
AskUserQuestionto let user pick the winner
Install
After user picks:
- Transform URL:
github.com/U/R/tree/B/P→raw.githubusercontent.com/U/R/B/P/SKILL.md(replace domain, remove/treefrom/tree/BRANCHleaving/BRANCH) - Fetch:
curl -s "RAW_URL" - Ask scope via
AskUserQuestion: global (~/.claude/skills/) or project-local (.claude/skills/) - Save as
{name}/SKILL.md, verify frontmatter, confirm activation
Mistakes & Errors
| Issue | Fix |
|---|---|
| Auto-selecting without asking | Always AskUserQuestion for user choice |
| Raw URL 404 | Verify /tree removed, domain replaced; try lowercase skill.md |
skill: null in AI results | Filter out before presenting |
| 0-star vs high-star conflict | Cross-check both search modes; review content of 0-star skills before installing |
| 401 | Check .skillsmp-key file |
| 429 | Daily quota hit, retry tomorrow |
| Curl exit 56 | Transient network error, retry |
Source
git clone https://github.com/Lu1sDV/skillsmd/blob/main/metaskills/skillsmp-search/SKILL.mdView on GitHub Overview
SkillsMP Search & Installer lets you browse 11,000+ community skills and install them locally. It supports fast keyword searches and AI semantic queries, presents all results in a ranked table, and guides you through comparing candidates before installation.
How This Skill Works
Queries hit the SkillsMP API to fetch skills data. Use Keyword or AI Semantic search to retrieve results with fields like id, name, author, description, githubUrl, stars, and updatedAt. The UI then shows all results in a ranked table and prompts you to pick via AskUserQuestion, offering a 'Compare to find best' option. For installation, transform the GitHub URL to a raw SKILL.md URL, fetch it, save as {name}/SKILL.md, verify frontmatter, and activate the skill.
When to Use It
- User asks to find, search, or install a skill
- User needs a capability that likely exists as a community skill
- User wants to compare multiple candidate skills before installation
- User is browsing the marketplace for a new capability to add
- User wants to install a skill locally and confirm activation
Quick Start
- Step 1: Place your SkillsMP API key at ~/.claude/skills/skillsmp-search/.skillsmp-key
- Step 2: Run a search using Keyword or AI Semantic endpoints to discover skills
- Step 3: After selecting a skill, transform the GitHub URL to a raw SKILL.md, fetch it, save as {name}/SKILL.md, verify frontmatter, and activate
Best Practices
- Use both Keyword and AI Semantic searches for broader coverage
- Present all found results in a ranked table and never auto-select
- Offer the 'Compare to find best' option to aid decision making
- Verify frontmatter and activation after saving SKILL.md
- Respect API rate limits (base/limit: 500/day) and keep the key secure
Example Use Cases
- Find a data parsing skill from the community and install it locally
- Search for an email automation skill using AI semantic search
- Compare three CSV processing skills before choosing one
- Install a GitHub-related skill by converting the URL to raw SKILL.md
- Resolve a 0-star vs high-star conflict by cross-checking content before installation
