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 on2026-02-08

NPX Install

npx skill4agent add gccszs/skillsmp-searcher skillsmp-searcher

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):

Environment variable (recommended): Set the
```
SKILLSMP_API_KEY
```
environment variable
Development key file: Create
```
references/api_key_real.txt
```
(already in .gitignore)
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

Endpoint	Method	Function
`/skills/search`	GET	Keyword search
`/skills/ai-search`	GET	AI semantic search

Error Handling

API error codes:

Error Code	HTTP Status	Description
`MISSING_API_KEY`	401	API Key not provided
`INVALID_API_KEY`	401	Invalid API Key
`MISSING_QUERY`	400	Required query parameter missing
`INTERNAL_ERROR`	500	Internal 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:

Ensure API Key is configured (prefer using environment variable
```
SKILLSMP_API_KEY
```
)
Select search mode based on needs:
- Clear keywords → Keyword search (
```
search_skills.py
```
  )
- Natural language description → AI semantic search (
```
ai_search.py
```
  )
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:

List installed skills:
```
install_skill.py list
```
View skill details:
```
skill_info.py "skill name"
```
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

skillsmp-searcher

NPX Install

Tags

SKILL.md Content (Chinese)

SkillsMP Skill Search

API Configuration

Search Modes

1. Keyword Search

2. AI Semantic Search

3. One-click Skill Installation

4. View Skill Details

5. Check Skill Updates

API Endpoints

Error Handling

Usage Flow