juanibiapina/dotfiles/find-skills

Find Skills

Search the SkillsMP marketplace (~900K skills indexed from GitHub) and load any candidate into the current session via load_skill.

Workflow

1. Search

Hit the public REST API. Anonymous works (50 req/day, 10 req/min, keyword search).

curl -fsSL "https://skillsmp.com/api/v1/skills/search?q=<query>&sortBy=stars&limit=10" | jq

Useful parameters:

• q (required) — keywords, max 200 chars
• sortBy — stars or recent (default: recent)
• limit — up to 50
• category — slug from <https://skillsmp.com/categories>
• occupation — SOC slug from <https://skillsmp.com/occupations>

Each result has: id, name, author, description, githubUrl, skillUrl, stars, updatedAt.

On HTTP 429, back off and tell the user (rate limit hit).

2. Filter

SkillsMP indexes the GitHub long tail; many useful skills sit at 0 stars. Don't hard-floor by stars.

In order of weight:

• description matches the user's intent
• Author/repo reputation — known-good: anthropics, vercel-labs, microsoft, obra, ComposioHQ
• Stars ≥10 is a soft positive signal; treat low stars as neutral, not disqualifying

3. Preview the skill text

Before recommending, read the actual SKILL.md. Convert the API's githubUrl to raw:

• githubUrl: https://github.com/<owner>/<repo>/tree/<ref>/<subpath>
• raw URL: https://raw.githubusercontent.com/<owner>/<repo>/<ref>/<subpath>/SKILL.md

One-liner (replaces /tree/ with / so neighbouring slashes survive):

RAW=$(echo "$githubUrl" | sed 's|github.com|raw.githubusercontent.com|; s|/tree/|/|')/SKILL.md
curl -fsSL "$RAW"

Skim the frontmatter and body to confirm fit and surface anything important (required tools, env vars, caveats).

4. Recommend

Show the user 1–3 options. For each:

• name (and author)
• one-line summary drawn from frontmatter description
• stars
• skillUrl for the marketplace page
• githubUrl for the source

Example:

Found a couple of options:
 
1. playwright by A-Kuo (0 stars)
   Browser automation from the terminal via playwright-cli.
   https://skillsmp.com/skills/a-kuo-cipher-cursor-skills-playwright-skill-md
   Source: https://github.com/A-Kuo/CIPHER/tree/main/.cursor/skills/playwright
 
2. ...
 
Want me to load one?

5. Load on confirm

Pass the API's githubUrl straight to the tool — it already has the right shape:

load_skill(source="<githubUrl>")

The tool returns the instructions and records the skill in the session context.

6. No matches

Say so, offer to do the task with general capabilities. Optionally suggest the user create their own skill (see the managing-skills skill).