skillsmp-searcher

Original：🇨🇳 Chinese
Translated
6 scriptsChecked / no sensitive code detected

SkillsMP Skill Marketplace Search and Management Tool. Provides complete functions for searching, viewing details, installing and updating skills on the https://skillsmp.com/ website. Supports two search modes: keyword search and AI semantic search. Use this tool when you need to: (1) Search for skills on specific topics (such as "SEO", "video production"), (2) Find relevant skills through natural language descriptions (such as "how to create a web scraper"), (3) View detailed skill information (version, author, rating, examples), (4) Install discovered skills with one click, (5) Check for updates of installed skills, (6) Manage local skill library.

4installs
Sourcegccszs/skillsmp-searcher
Added on

NPX Install

npx skill4agent add gccszs/skillsmp-searcher skillsmp-searcher

Tags

Translated version includes tags in frontmatter
skill-marketplace-searchskill-installationai-semantic-searchupdate-monitoringskill-library-management

SKILL.md Content (Chinese)

View Translation Comparison →

SkillsMP Skill Search

This tool provides search functionality for the SkillsMP Skill Marketplace, helping users quickly discover and locate the skills they need.

API Configuration

Before first use, you need to configure the API Key. Three configuration methods are supported (sorted by priority):
  1. Environment variable (recommended): Set the 
    SKILLSMP_API_KEY
    environment variable
  2. Development key file: Create 
    references/api_key_real.txt
    (already in .gitignore)
  3. Template file: Edit 
    references/api_key.txt
Format: Plain text API Key string (e.g., 
sk_live_skillsmp_eb_6A4Y9LJAhtzPFsmX0v67zhingVC0CrQZ4Qqlin4
)
Notes:
  • api_key_real.txt
    has been added to .gitignore and will not be committed to public repositories
  • Do not commit files containing real API Keys to public repositories
  • Files support comment lines starting with 
    #
    , which will be automatically skipped

Search Modes

1. Keyword Search

Use 
scripts/search_skills.py
for keyword-based search.
Applicable scenarios:
  • Users search with clear keywords (e.g., "SEO", "PDF", "translation")
  • Need to sort by popularity or latest time
  • Need to browse results by pages
Parameters:
  • q
    (required): Search keyword
  • page
    : Page number, default 1
  • limit
    : Number of items per page, default 20, maximum 100
  • sortBy
    : Sort method, 
    stars
    (popular, default) or 
    recent
    (latest)
Example:
bash
python scripts/search_skills.py "SEO" --page 1 --limit 10 --sortBy stars

2. AI Semantic Search

Use 
scripts/ai_search.py
for semantic understanding-based search.
Applicable scenarios:
  • Users describe needs in natural language (e.g., "how to make videos", "help me process PDF documents")
  • Search intent is complex and requires context understanding
  • Unsure of specific keywords, hoping for AI intelligent matching
Parameters:
  • q
    (required): Natural language search query
Example:
bash
python scripts/ai_search.py "How to create a web scraper"

3. One-click Skill Installation

Use 
scripts/install_skill.py
to search and install skills.
Commands:
  • install
    [query] [--index N]: Search and install the Nth skill (default 1st)
  • install
    [url/path]: Install directly from URL or local path
  • list
    : List all installed skills
Examples:
bash
# Search and install the first result
python scripts/install_skill.py install "视频编辑"

# Search and install the skill at specified index
python scripts/install_skill.py install "PDF" --index 2

# Install directly from URL
python scripts/install_skill.py install "https://example.com/skill.skill"

# Install from local file
python scripts/install_skill.py install "/path/to/skill.skill"

# List installed skills
python scripts/install_skill.py list
Features:
  • Automatically extract and install skills to Claude Code skill directory
  • Support installation from URL or local file
  • List all installed skills

4. View Skill Details

Use 
scripts/skill_info.py
to view detailed information of specific skills.
Applicable scenarios:
  • Need to understand complete information of a skill
  • View skill version, author, rating, tags
  • Obtain skill usage examples and installation commands
Parameters:
  • skill_id
    (required): Skill ID or name
  • --json
    : Output in raw JSON format
  • --api-key
    : Custom API key
Examples:
bash
# View detailed skill information
python scripts/skill_info.py "pdf-processor"

# Output in JSON format
python scripts/skill_info.py "video-editor" --json
Display content:
  • Skill name, author, star rating
  • Version number and detailed description
  • Category tags
  • Repository link and installation command
  • Dependency requirements
  • Usage examples

5. Check Skill Updates

Use 
scripts/check_updates.py
to check for updates of installed skills.
Applicable scenarios:
  • Regularly check if installed skills have new versions
  • Obtain the version number and rating of the latest version
  • Decide whether to update skills
Parameters:
  • --force
    : Force check (ignore cache)
  • --json
    : Output in JSON format
  • --api-key
    : Custom API key
Examples:
bash
# Check updates for all installed skills
python scripts/check_updates.py

# Force check (bypass 1-hour cache)
python scripts/check_updates.py --force

# Output in JSON format
python scripts/check_updates.py --json
Features:
  • Automatically scan Claude Code skill directory
  • Compare local version with the latest version in SkillsMP Marketplace
  • Intelligent caching mechanism (no repeated checks within 1 hour)
  • Display upgrade path and installation command for updatable skills

API Endpoints

For detailed API documentation, please refer to 
references/api_documentation.md
.
Base URL: 
https://skillsmp.com/api/v1
EndpointMethodFunction
/skills/search
GETKeyword search
/skills/ai-search
GETAI semantic search

Error Handling

API error codes:
Error CodeHTTP StatusDescription
MISSING_API_KEY
401API Key not provided
INVALID_API_KEY
401Invalid API Key
MISSING_QUERY
400Required query parameter missing
INTERNAL_ERROR
500Internal server error
Error response format:
json
{
  "success": false,
  "error": {
    "code": "INVALID_API_KEY",
    "message": "The provided API key is invalid"
  }
}

Usage Flow

Search and Install Skills:
  1. Ensure API Key is configured (prefer using environment variable 
    SKILLSMP_API_KEY
    )
  2. Select search mode based on needs:
    • Clear keywords → Keyword search (
      search_skills.py
      )
    • Natural language description → AI semantic search (
      ai_search.py
      )
  3. Install directly after search:
    • Install using index: 
      install_skill.py install "keyword" --index N
    • Install directly from URL: 
      install_skill.py install "URL"
Manage Installed Skills:
  1. List installed skills: 
    install_skill.py list
  2. View skill details: 
    skill_info.py "skill name"
  3. Check for updates: 
    check_updates.py
Notes:
  • API Key must be configured for first use
  • Search results are sorted by popularity by default
  • Skills are installed to 
    ~/.claude/skills/
    or the corresponding system skill directory
  • Update check has a 1-hour cache, use 
    --force
    to bypass