SkillsMP Searcher

English | 简体中文

---

SkillsMP Searcher is a Claude Code skill that enables powerful search capabilities for the SkillsMP skill marketplace. It provides both keyword-based search and AI-powered semantic search to help you quickly discover and install useful skills.

Features

• Keyword Search: Search skills by specific keywords with pagination and sorting options
• AI Semantic Search: Use natural language queries to find relevant skills powered by Cloudflare AI
• Cross-Platform: Works on Windows, macOS, and Linux
• Python 3.9+: Supports Python 3.9, 3.10, 3.11, and 3.12
• Secure API Key Management: Multiple configuration methods with security best practices
• One-Click Installation: Install skills directly from search results
• Update Checker: Automatically check for updates to installed skills

Installation

Choose one of the following methods to install SkillsMP Searcher:

Method 1: NPX Quick Install (Recommended)

The fastest way to install directly from GitHub:

npx skills add gccszs/skillsmp-searcher

This will automatically download and install the latest version of the skill.

Method 2: Install from Release File

1. Download the latest skillsmp-searcher.skill from Releases
2. Install using Claude Code CLI:

   claude skill install skillsmp-searcher.skill

Method 3: Install from GitHub

# Clone the repository
git clone https://github.com/gccszs/skillsmp-searcher.git

# Install from local directory
claude skill install skillsmp-searcher/skills/skillsmp-searcher

Method 4: One-Line Install (PowerShell)

# Download and install in one command
Invoke-WebRequest -Uri "https://github.com/gccszs/skillsmp-searcher/releases/latest/download/skillsmp-searcher.skill" -OutFile "skillsmp-searcher.skill"; claude skill install skillsmp-searcher.skill

Method 5: One-Line Install (Bash)

# Download and install in one command
curl -L https://github.com/gccszs/skillsmp-searcher/releases/latest/download/skillsmp-searcher.skill -o skillsmp-searcher.skill && claude skill install skillsmp-searcher.skill

Verify Installation

claude skill list

You should see skillsmp-searcher in the list of installed skills.

Configuration

API Key Setup

Before using this skill, you need to configure your SkillsMP API key. Choose one of the following methods:

Method 1: Environment Variable (Recommended)

# Linux/macOS - Add to ~/.bashrc or ~/.zshrc
export SKILLSMP_API_KEY="sk_live_skillsmp_your_actual_key_here"

# Windows PowerShell
[System.Environment]::SetEnvironmentVariable('SKILLSMP_API_KEY', 'sk_live_skillsmp_your_actual_key_here', 'User')

Method 2: Configuration File (For Development)

# Create file: skills/skillsmp-searcher/references/api_key_real.txt
# Paste your API key (only the key, nothing else)
sk_live_skillsmp_your_actual_key_here

Method 3: Command-Line Argument (One-Time Use)

python skills/skillsmp-searcher/scripts/search_skills.py "SEO" --api-key "your_key_here"

Security Best Practices

• Never commit API keys to version control
• Use environment variables for production deployments
• Rotate compromised keys immediately at SkillsMP Dashboard
• Monitor API usage for unusual activity

Tip: Copy .env.example to .env and fill in your API key for local development. The .env file is automatically gitignored.

Usage

Keyword Search

Search for skills using specific keywords:

python skills/skillsmp-searcher/scripts/search_skills.py "SEO" --limit 10 --sort stars

Parameters:

• query: Search keyword (required)
• --page: Page number (default: 1)
• --limit: Items per page (default: 20, max: 100)
• --sort: Sort by stars (default) or recent

AI Semantic Search

Search using natural language:

python skills/skillsmp-searcher/scripts/ai_search.py "How to create a web scraper"

One-Click Skill Installation

Install skills directly from search results:

# Search and install the first result
python skills/skillsmp-searcher/scripts/install_skill.py install "video editing"

# Search and install by index
python skills/skillsmp-searcher/scripts/install_skill.py install "PDF" --index 2

# Install from direct URL
python skills/skillsmp-searcher/scripts/install_skill.py install "https://github.com/user/repo/releases/latest/download/skill.skill"

# List installed skills
python skills/skillsmp-searcher/scripts/install_skill.py list

Installation Options:

• query: Search query or direct URL/path to .skill file
• --index N: Install the Nth skill from search results (default: 1)
• --page N: Search page number (default: 1)
• --sort: Sort by stars (default) or recent

View Skill Details

Get detailed information about a specific skill:

python skills/skillsmp-searcher/scripts/skill_info.py "skill-name"

Details include:

• Author and stars
• Version information
• Full description
• Tags and categories
• Installation commands
• Usage examples

Check for Updates

Check all installed skills for available updates:

# Check for updates (respects 1-hour cache)
python skills/skillsmp-searcher/scripts/check_updates.py

# Force check even if recently checked
python skills/skillsmp-searcher/scripts/check_updates.py --force

# Output in JSON format
python skills/skillsmp-searcher/scripts/check_updates.py --json

Features:

• Checks all installed skills against SkillsMP marketplace
• Smart caching (checks at most once per hour)
• Shows current vs latest version
• One-line update commands

API Documentation

• Official API Documentation: https://skillsmp.com/docs/api
• Local Reference: skills/skillsmp-searcher/references/api_documentation.md

Development

Running Tests

# Install dependencies
pip install -r requirements.txt

# Run tests
pytest

# Run tests with coverage
pytest --cov=scripts

Code Quality

# Format code
black scripts/

# Check code style
flake8 scripts/

# Type checking
mypy scripts/

Project Structure

skillsmp-searcher/
├── .github/
│   └── workflows/          # CI/CD workflows
├── skills/
│   └── skillsmp-searcher/  # Skill package
│       ├── SKILL.md        # Skill metadata
│       ├── scripts/        # Executable scripts
│       ├── references/     # Documentation and configs
│       └── assets/         # Resource files
├── tests/                  # Test suite
├── requirements.txt        # Python dependencies
└── README.md              # This file

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Links

• SkillsMP Marketplace
• GitHub Repository
• Issue Tracker