Skillstore

# SkillStore - OpenClaw Skill Manager

Search, install, and create OpenClaw skills with intelligent matching.

## Skill Metadata

- **Name**: skillstore
- **Type**: OpenClaw Skill
- **Purpose**: Search existing skills, install from GitHub, or create new ones

## Setup Commands

No setup required. Works out of the box.

## Usage Commands

### Search & Install

```bash
# Search for a skill (applies 30% threshold)
skillstore <query>

# Examples:
skillstore home assistant
skillstore weather
skillstore smart home
skillstore email gmail
skillstore github
```

### List & Show

```bash
# List installed skills
skillstore list

# Show all known skills (20 built-in)
skillstore known
```

### Create New

```bash
# Create new skill with templates
skillstore create <name>
skillstore new <name>

# Examples:
skillstore create my-awesome-skill
skillstore new weather-widget
```

## How Search Works

### Matching Algorithm

1. **Tokenize** - Split query into keywords
2. **Calculate** - Jaccard similarity + keyword boost
3. **Filter** - Remove results below 30% threshold
4. **Rank** - Sort by relevance score
5. **Display** - Show with visual score bar

### Match Score

```
Score >= 50% = Strong match (green bar)
Score >= 30% = Weak match (yellow bar)  
Score < 30% = Not shown (filtered)
```

### Search Sources (in order)

1. **Known Skills** - Built-in database of 20 skills
2. **Local Skills** - Skills in ~/.openclaw/workspace/skills/
3. **GitHub** - Search openclaw repositories

## Interaction Flow

```
1. User runs: skillstore home assistant
2. System searches all 3 sources
3. System filters by threshold
4. Results shown with scores:

   1. [KNOWN] homeassistant ████████░░ 85%
      Control smart home devices...
   2. [LOCAL] homeassistant ███████░░░ 78%
   3. [GIT] openclaw-homeassistant ██████░░░░ 62%

5. User chooses:
   - Enter number → Install from GitHub
   - n → Create new skill
   - q → Quit
```

## Known Skills Database

Built-in skills (searchable):

| Skill | Description |...

# SkillStore - Intelligent OpenClaw Skill Manager

Smart skill search with semantic matching and relevance threshold filtering.

## Features

- **Semantic Matching** - Analyzes actual skill functionality, not just keywords
- **Relevance Threshold** - Only shows skills with 30%+ match score
- **Multi-source Search** - Known skills, local skills, GitHub repos
- **Scoring System** - Shows match percentage with visual bar

## How It Works

### Matching Algorithm

1. **Tokenization** - Breaks query into keywords
2. **Jaccard Similarity** - Measures word overlap
3. **Keyword Boost** - Extra points for exact keyword matches
4. **Name Boost** - Extra points for name matches
5. **Threshold Filter** - Only shows scores >= 30%

### Match Threshold

```
Score >= 50% = Strong match (green bar)
Score >= 30% = Weak match (yellow bar)
Score < 30% = Not shown
```

## Quick Start

```bash
# Search with threshold filtering
skillstore smart home
skillstore weather forecast
skillstore email gmail

# List / Known
skillstore list
skillstore known
skillstore create my-skill
```

## Search Example

```
$ skillstore smart home

Search Results for "smart home"
Match threshold: 30% | Found: 3

1. [KNOWN] homeassistant ████████░░ 85% (STRONG)
   Control smart home devices like lights switches...
2. [LOCAL] homeassistant ███████░░░ 78%
   Home Assistant skill for OpenClaw
3. [GIT] openclaw-homeassistant ██████░░░░ 62%
   Control smart home devices

Enter number to install or 'n' to create new
```

## Why Threshold?

Prevents irrelevant results. A skill named "weather" won't show up for "email" just because it has some matching letters.

## Commands

| Command | Description |
|---------|-------------|
| `skillstore <query>` | Search with threshold |
| `skillstore list` | List installed |
| `skillstore known` | Show all known skills |
| `skillstore create <name>` | New skill |

## Configuration

- **Threshold**: 30% (configurable in code)
- **Search Sources**: Known → Local → GitHub
- **Deduplicat...