[!NOTE] This step only needs to be run once. Python's requests library is the only external dependency required.

API Key Configuration

Before running any search script, check if .env file exists:

# Check if .env exists
test -f .env && echo "Configured" || echo "Not configured"

Option 1: Using setup script (Recommended)

python scripts/setup.py <API_KEY>

Option 2: Create .env file directly

Create a .env file with the following content:

SKILLSMP_API_KEY=sk_live_skillsmp_xxxxxxxxxx

[!TIP] Get your API Key from SkillsMP API Settings

Features

Search the skill library using keywords.

Usage:

python scripts/search.py "<keyword>" [page] [per_page] [sort]

Parameters:

Examples:

# Basic search
python scripts/search.py "SEO"

# With pagination and sorting
python scripts/search.py "web scraper" 1 10 stars

Use AI-powered semantic search (Cloudflare AI).

Usage:

python scripts/ai_search.py "<query>"

Parameters:

Parameter	Required	Description
query	✓	Natural language query

Examples:

python scripts/ai_search.py "How to create a web scraper"
python scripts/ai_search.py "skills for building REST APIs"

Search skills and get installation command suggestions.

Usage:

python scripts/install_helper.py "<keyword>" [limit]

Parameters:

Parameter	Required	Description
keyword	✓	Skill keyword to search
limit		Number of results to show, default: 5

Examples:

python scripts/install_helper.py "spring boot"
python scripts/install_helper.py "react" 10

Output includes:

This skill integrates with add-skill CLI to install skills directly from Git repositories.

The add-skill tool installs skills from any Git repository.

Install specific skill to global scope (User-level):

npx add-skill <owner>/<repo> --skill "<skill-name>" -g -a antigravity -y

Install ALL skills from a repo:

npx add-skill <owner>/<repo> -g -a antigravity -y

Install to project scope (Local):

npx add-skill <owner>/<repo> --skill "<skill-name>" -a antigravity -y

List available skills in a repo:

npx add-skill <owner>/<repo> --list

Search for skills Use the helper script to find the repository and skill name:
```
python scripts/install_helper.py "spring boot"
```
Verify repository content List all skills available in the repository:
```
npx add-skill <owner>/<repo> --list
```
Install the skill Choose one of the installation commands above. For most cases, use the Global Install:
```
npx add-skill <owner>/<repo> --skill "<skill-name>" -g -a antigravity -y
```
Verify Installation Check if the skill files are created in the agent's skill directory.

Success Response:

{
  "success": true,
  "data": {
    "skills": [...]
  }
}

Error Response:

{
  "success": false,
  "error": {
    "code": "ERROR_CODE",
    "message": "Error message"
  }
}

When a user requests SkillsMP search functionality:

Check if .env exists
- If exists → Run search script directly
- If not → Guide user through setup
Guide user to get API Key
- Direct user to https://skillsmp.com/settings/api
- Ask user to provide the API Key
Configure API Key
- Use setup.py script or create .env file
- Verify setup before running search

[!CAUTION] The .env file contains sensitive information and is excluded from Git. Never share or expose your API Key publicly.