git:20260314.e72859e to git:20260411.b7d927a

11 added, 18 removed. Audit A to A.

---

name: skillsmp-search

description: Use when finding, browsing, or installing community skills, or when a needed capability might exist as a marketplace skill. Triggers on "find a skill", "search skills", "install skill", "skillsmp", or "marketplace".

---

# SkillsMP 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.

## Quick Reference

| Step | Action |

|------|--------|

| Search | `GET https://skillsmp.com/api/skills?q=<query>&sortBy=recent` |

| Present | Show top 3-5 results with name, author, description, install count |

| Install | `npx skills add <author>/<repo>` or copy to `~/.claude/skills/` |

| Verify | Ask Claude "What skills are available?" |

## API Config

- **Base**: `https://skillsmp.com/api/v1/skills`

- - **Key**: `cat ~/.claude/skills/skillsmp-search/.skillsmp-key`

- - **Auth**: `Authorization: Bearer <key>` | **Limit**: 500/day

+ - **Key**: `$SKILLSMP_API_KEY` environment variable

+ - **Auth**: `Authorization: Bearer $SKILLSMP_API_KEY` | **Limit**: 500/day

## Search

**Keyword** (fast, ~500ms) - specific terms, sort by stars:

```bash

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)"

+ -H "Authorization: Bearer $SKILLSMP_API_KEY"

```

Response: `data.skills[]` → `id`, `name`, `author`, `description`, `githubUrl`, `stars`, `updatedAt`

**AI Semantic** (smart, ~5s) - natural language, conceptual queries:

```bash

curl -s "https://skillsmp.com/api/v1/skills/ai-search?q=QUERY" \

- -H "Authorization: Bearer $(cat ~/.claude/skills/skillsmp-search/.skillsmp-key)"

+ -H "Authorization: Bearer $SKILLSMP_API_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:

```

|---|-------|--------|-------|-------------|

| 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":

1. **Gather criteria**: Ask user to expand needs/priorities (optional)

- 2. **Fetch & evaluate**: Download SKILL.md from top candidates, score each 0-2 per dimension:

- | Dimension | Strong (2) | Red flags (0-1) |

- |---|---|---|

- | **Trigger precision** | WHAT + WHEN in description, specific trigger phrases, third-person voice, ≤1024 chars | Vague ("helps with projects"), missing triggers, first/second person voice |

- | **Token efficiency** | Body ≤500 lines, assumes Claude's baseline knowledge, large content split to references/ | Verbose explanations of basics, everything inlined |

- | **Progressive disclosure** | References one level deep, TOC on 100+ line files, domain-organized refs | Nested refs (A→B→C), no TOC on long files, flat dump |

- | **Workflow clarity** | Clear steps, validation/feedback loops, freedom matched to task fragility | No validation gates, ambiguous ordering, over-constraining creative tasks |

- | **Domain value** | Non-obvious gotchas, silent-error warnings, version-specific traps, troubleshooting beyond official docs | Only restates what Claude already knows or what official docs cover |

- | **Practical quality** | Error handling in scripts, consistent terminology, deps listed, forward-slash paths | Magic constants, Windows paths, too many tool options without a default |

- 3. **Present comparison**: Side-by-side table with per-dimension scores (total /12), SKILL.md token length, and 1-sentence key finding per candidate

- 4. **Final decision**: Use `AskUserQuestion` to let user pick the winner

+ 2. **Load evaluation rubric**: Read `external/writing-skills-rubric.md` for the full scoring framework (6 dimensions, 0-2 each, /12 total)

+ 3. **Fetch & evaluate**: Download SKILL.md from top candidates, score per rubric dimensions:

+ - Description quality (CSO) | Token efficiency | Structure & organization

+ - Degrees of freedom | Domain value | Code & examples

+ 4. **Present comparison**: Side-by-side table with per-dimension scores (total /12), SKILL.md word count (`wc -w`), and 1-sentence key finding per candidate

+ 5. **Final decision**: Use `AskUserQuestion` to let user pick the winner

Consult `external/anthropic-skills-best-practices.md` for edge-case evaluation details only.

## Install

After user picks:

1. **Transform URL**: `github.com/U/R/tree/B/P` → `raw.githubusercontent.com/U/R/B/P/SKILL.md` (replace domain, remove `/tree` from `/tree/BRANCH` leaving `/BRANCH`)

2. **Fetch**: `curl -s "RAW_URL"`

3. **Ask scope** via `AskUserQuestion`: global (`~/.claude/skills/`) or project-local (`.claude/skills/`)

4. **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 |

+ | 401 | Check `$SKILLSMP_API_KEY` is set — run `echo $SKILLSMP_API_KEY` |

| 429 | Daily quota hit, retry tomorrow |

| Curl exit 56 | Transient network error, retry |

## Common Mistakes

| Mistake | Fix |

|---------|-----|

| Installing without checking existing skills | Run "What skills are available?" first |

| Using wrong install path | Skills go in `~/.claude/skills/<skill-name>/SKILL.md` |

| Searching too broadly ("testing") | Be specific: "playwright e2e testing" |

| Installing multiple overlapping skills | Check descriptions for overlap before installing |

| Forgetting to verify after install | Always confirm skill loaded with a test prompt |