kevintsai1202/skillmp-api

Overview

This skill provides search and discovery tools for the SkillsMP marketplace, letting you find AI skills by keyword or with AI-powered semantic queries. It includes helper scripts for installation suggestions and integrates with an add-skill CLI workflow to install skills into multiple agent directories. The tool requires a SkillsMP API key and minimal Python setup.

How this skill works

The skill uses simple Python scripts to call the SkillsMP API: keyword search for traditional filtering and Cloudflare AI semantic search for natural-language queries. It returns structured JSON responses with skill metadata (name, author, stars, description) and provides GitHub search links and installation command suggestions. A setup script or .env file configures the required API key before queries run.

When to use it

• You need to find AI skills or code examples related to a specific topic or problem.
• You prefer natural-language queries and want semantic matches instead of exact keyword hits.
• You want installation commands and repository references to quickly add skills to an agent.
• You are compiling curated lists of skills by popularity or recent additions.
• You need to automate skill discovery in CI or development tooling that consumes JSON results.

Best practices

• Keep your SKILLSMP_API_KEY secret; store it in .env and never commit it to source control.
• Use the setup.py script to configure the key for consistent environment handling.
• Start with semantic search for broad queries, then refine with keyword search and sort by stars or recent.
• Limit per_page to reasonable values (default 20, max 100) when paginating to avoid large responses.
• Verify repository contents with npx add-skill --list before installing to avoid unexpected packages.

Example use cases

• Search for 'web scraper' to find reusable scraping skills and see install commands for your agent.
• Ask semantic queries like 'skills for building REST APIs' to uncover relevant modules and tutorials.
• Generate a shortlist of top-rated skills (sorted by stars) for a project onboarding checklist.
• Automate a pipeline that discovers new skills weekly and reports additions in JSON format.
• Use install_helper.py to produce direct npx add-skill commands for team-wide installs.