SkillsMP Search Skill | Agent Skills

SkillsMP Search

Overview

Provide programmatic access to the SkillsMP skills marketplace through REST API integration. This skill enables both keyword-based and AI semantic search capabilities to discover community-built AI skills. Use keyword search for exact terms and filtering, or AI search for natural language queries and semantic matching.

Setup

Before using this skill, set the SkillsMP API key as an environment variable:

Linux/Mac:

export SKILLSMP_API_KEY='your_api_key_here'

Windows (Command Prompt):

set SKILLSMP_API_KEY=your_api_key_here

Windows (PowerShell):

$env:SKILLSMP_API_KEY='your_api_key_here'

To obtain an API key, visit https://skillsmp.com/docs/api and click "Generate API Key".

When to Use This Skill

Invoke this skill when users:

Ask to search for specific skills or capabilities (e.g., "Find a web scraping skill")
Want to discover skills related to a topic (e.g., "What skills are available for automation?")
Need to explore the SkillsMP marketplace programmatically
Request natural language skill discovery (e.g., "How can I build a chatbot?")
Want to find popular or recent skills in a specific domain

Core Capabilities

1. Keyword Search

Execute precise keyword-based searches with pagination and sorting options.

Use Cases:

Finding skills by exact name or keyword
Filtering results by popularity (stars) or recency
Browsing paginated results for comprehensive discovery

Example Invocation:

python scripts/skillsmp_search.py keyword "web scraper" 1 20 stars

Parameters:

Query: Search term (required)
Page: Page number (default: 1)
Limit: Results per page (default: 20, max: 100)
Sort: 'stars' for popularity or 'recent' for newest

2. AI Semantic Search

Execute natural language queries using Cloudflare AI-powered semantic search.

Use Cases:

Natural language skill discovery
Finding skills by use case or problem description
Semantic matching beyond exact keywords

Example Invocation:

python scripts/skillsmp_search.py ai "How to create a web scraper for e-commerce sites"

Parameters:

Query: Natural language question or description (required)

Workflow Decision Tree

User requests skill search
    │
    ├─ Exact keyword or skill name known?
    │   └─ YES → Use keyword search
    │       ├─ Need popular results? → Sort by 'stars'
    │       └─ Need latest results? → Sort by 'recent'
    │
    └─ Natural language query or use case?
        └─ YES → Use AI semantic search

Using the Search Script

The scripts/skillsmp_search.py script provides command-line access to both search methods.

Keyword Search Examples

Basic Search:

python scripts/skillsmp_search.py keyword "automation"

Sorted by Popularity:

python scripts/skillsmp_search.py keyword "SEO" 1 20 stars

Sorted by Recency:

python scripts/skillsmp_search.py keyword "data analysis" 1 20 recent

Paginated Results:

# Get page 2 with 50 results per page
python scripts/skillsmp_search.py keyword "web development" 2 50

AI Search Examples

Problem-Based Search:

python scripts/skillsmp_search.py ai "How to extract data from PDFs"

Use Case Search:

python scripts/skillsmp_search.py ai "I need to automate email responses"

Feature Discovery:

python scripts/skillsmp_search.py ai "Skills for image processing and computer vision"

Integration with Workflow

Direct Script Execution

Execute the search script directly when users request skill searches. The script handles authentication, API communication, error handling, and formatted output.

Programmatic Integration

For Python-based workflows, import and use the functions directly:

from scripts.skillsmp_search import keyword_search, ai_search

# Keyword search
results = keyword_search("automation", page=1, limit=20, sort_by="stars")

# AI search
results = ai_search("How to build a recommendation system")

Error Handling

The script handles common errors automatically:

Missing API key
Invalid parameters
Network failures
API rate limits

Check the success field in responses:

if not results.get("success", True):
    error = results.get("error", {})
    print(f"Error: {error.get('message')}")

API Reference

For detailed API documentation, including authentication, endpoints, response formats, and error codes, refer to references/api_reference.md.

Key points:

Base URL: https://skillsmp.com/api/v1
Authentication: Bearer token (pre-configured in script)
Rate limits: Standard API rate limiting applies
Maximum results per page: 100

Best Practices

Choose the Right Search Method:
- Use keyword search when users provide specific terms
- Use AI search for natural language questions or use cases
- Default to AI search when query intent is unclear
User Consent for Installation:
- 특정 스킬을 설치하려는 경우, 반드시 사용자의 동의를 받을 것
Result Presentation:
- Show skill name, description, and relevance/popularity
- Include URLs for users to explore further
- Limit initial results to 20 for readability
Pagination:
- Start with page 1 and default limit (20)
- Increase limit only when users request more results
- Use pagination for large result sets
Sorting Strategy:
- Use 'stars' sort for general queries (shows popular, vetted skills)
- Use 'recent' sort when users want latest capabilities
- AI search automatically ranks by relevance

Resources

scripts/skillsmp_search.py

Python script providing both keyword and AI search functionality with formatted output and error handling. Can be executed directly from command line or imported as a module.

references/api_reference.md

Comprehensive API documentation including endpoints, authentication, request/response formats, error codes, and usage examples.

Agent Skills: SkillsMP Search

Install this agent skill to your local

Skill Files