skill-matcher

# Skill Matcher

Automatically analyzes user prompts and recommends the most relevant skills from installed plugins and external catalogs.

## Workflow

### Phase 1: Analyze User Intent

Extract from user's message:
1. **Task type**: document creation, coding, design, communication, testing
2. **Keywords**: file formats (.pdf, .docx), tools (MCP, webapp), domains (brand, slides)
3. **Action verbs**: create, edit, analyze, test, build, design

### Phase 2: Match Skills

1. **Scan local skills** using `scripts/scan_skills.py`
2. **Match by category** (see Category Mapping below)
3. **Rank by relevance**: exact keyword match > category match > partial match
4. **Search external catalogs** if no local match (see [external-sources.md](references/external-sources.md))

### Phase 3: Recommend & Activate

Output format:
```
📋 **Recommended skills for your task:**

1. **[skill-name]** ⭐ (high relevance)
   → [why this skill matches your task]

2. **[skill-name]** (medium relevance)
   → [why this skill might help]

💡 Reply with skill number to activate, or "all" for all recommended.
```

After user confirms, activate the skill by mentioning it in context.

## Category Mapping

| Category | Keywords | Skills |
|----------|----------|--------|
| **Documents** | pdf, docx, word, excel, xlsx, powerpoint, pptx, slides, spreadsheet, document, форма, документ, презентация, таблица | pdf, docx, pptx, xlsx |
| **Development** | mcp, server, api, webapp, web app, artifact, component, код, сервер | mcp-builder, web-artifacts-builder |
| **Design** | art, design, canvas, theme, visual, frontend, ui, дизайн, тема, искусство | algorithmic-art, canvas-design, frontend-design, theme-factory |
| **Communication** | brand, guidelines, internal, memo, announcement, slack, gif, бренд, коммуникация | brand-guidelines, internal-comms, slack-gif-creator |
| **Testing** | test, qa, testing, webapp test, тест | webapp-testing |
| **Meta** | skill, create skill, новый скилл | skill-creator |

## Qu