Search the SkillsMP marketplace for agent skills from the command line.
Requires uv.
uv tool install skillsmp
Or run without installing:
uvx skillsmp terraform
Set your API key in ~/.env or export it directly:
SKILLSMP_API_KEY=your-key-here
skillsmp terraform
skillsmp --limit 5 --sort recent react testing
skillsmp --ai "how to optimize database queries"
skillsmp show wshobson/terraform-module-library
Use --json for structured output or --plain for tab-separated lines that pipe to grep and awk:
skillsmp --json deployment
skillsmp --plain react | grep facebook
The default keyword search matches your query against skill names and descriptions, sorted by stars. It's fast (~300ms) and supports pagination, but ranks by popularity rather than relevance.
--ai runs a vector similarity search powered by Cloudflare Vectorize. Each skill's full SKILL.md has been embedded, and your query is compared against those embeddings. This returns ~10 results ranked by relevance score, catching semantically related skills that keyword search misses. Pagination and sorting don't apply. Slower (~4-5s) because the query must be embedded first.
The categories and occupations commands list SkillsMP's taxonomy — skill categories grouped by domain, and the SOC occupation slugs the site organizes skills under. Neither needs an API key — categories come from the SkillsMP MCP server and occupations from the site's public sitemap:
skillsmp categories
skillsmp occupations | grep engineer
show prints everything about one skill — full description, links, and its SKILL.md fetched straight from GitHub:
skillsmp show wshobson/terraform-module-library
skillsmp show --json wshobson/terraform-module-library
-a, --ai AI semantic search
-n, --limit N Results per page (1-100, default: 10)
-p, --page N Page number (default: 1)
-s, --sort KEY Sort by: stars, recent (default: stars)
-j, --json JSON output
--plain Tab-separated, one line per result
-h, --help Show help
--version Show version
--limit, --page, and --sort apply to keyword search only.