Skill Search

提供三种 Skill 检索模式：BM25 关键词搜索、基于本地 miniLM 嵌入的语义搜索、以及 LLM 任务匹配推荐；输出匹配到的 Skill 名称及得分或置信度、推荐理由。搜索索引存放在宿主工作区内，首次语义搜索时自动建立，也可手动重建。

at6132

热度 77.61

最近更新 2026-05-11 17:26:30

分类：搜索依赖：代码执行 / 读写文件 / 内部调用大模型应用场景：研究 / 推荐 / 工作流

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add fitcheck-skill-search

Metadata

name: skill-search
description: Find and retrieve available skills using keyword search, semantic search, or LLM-powered task matching. Use when the agent needs to discover, search, or intelligently match skills to tasks. Supports hybrid search (BM25 + semantic), natural language task descriptions, and intelligent skill recommendations.
triggers: ["search skills","find a skill","what skills are available","skill for X","suggest skills for","what skill should I use","recommend a skill"]

Skill Search V1.1

Find skills using keyword, semantic, or AI-powered task matching.

Overview

This skill provides three search modes:

Keyword Search (Fast BM25) — Match skill names and descriptions
Semantic Search (Embeddings) — Find skills by meaning/concept similarity
LLM Task Matching (AI-powered) — Describe your task, get skill recommendations

When to Use

Before starting a new task — check if a relevant skill exists
When user asks for capabilities — "what can you do with PDFs?"
To avoid context bloat — find the right skill first, then load only that one
When unsure which skill applies — use semantic or LLM matching for fuzzy matches

Search Modes

1. Keyword Search (Fast)

./scripts/skill_search.py keyword "weather"
./scripts/skill_search.py keyword "pdf"
./scripts/skill_search.py keyword "image generation"

2. Semantic Search (Meaning-based)

./scripts/skill_search.py semantic "automate web browsing"
./scripts/skill_search.py semantic "create images with AI"
./scripts/skill_search.py semantic "search my past conversations"

3. LLM Task Matching (AI-powered)

./scripts/skill_search.py suggest "I need to transcribe a podcast episode"
./scripts/skill_search.py suggest "Help me generate product photos"
./scripts/skill_search.py suggest "Search through my old emails"

4. List All Skills

./scripts/skill_search.py list

Usage Pattern

Search: Find skills matching your need (keyword/semantic/LLM)
Preview: Read SKILL.md metadata (description, triggers)
Load: If it's the right skill, read full body and execute

Example Workflows

User: "I need to generate some images"

Agent: Uses semantic search

./scripts/skill_search.py semantic "generate images AI"

Output:

Top matches (semantic):
1. openai-image-gen (0.87) — Batch-generate images via OpenAI Images API
2. browser (0.65) — Control web browser via Playwright

Agent: Reads SKILL.md, confirms fit, executes

User: "What skill should I use for transcribing audio?"

Agent: Uses LLM suggest

./scripts/skill_search.py suggest "transcribe audio"

Output:

Recommended skills for "transcribe audio":

1. openai-whisper-api — Transcribe audio via OpenAI Audio Transcriptions API (Whisper)
   Confidence: High
   Reason: Task explicitly matches skill purpose

2. sag — ElevenLabs text-to-speech (inverse operation, may be related)
   Confidence: Low
   Reason: Related to audio processing but output not input

Search Index

The skill maintains a local search index at:

~/.openclaw/workspace/skills/skill-search/index/skills_index.json — Skill metadata
~/.openclaw/workspace/skills/skill-search/index/embeddings.json — Semantic embeddings (lazy-loaded)

Indexing happens automatically on first semantic search if no index exists.

Force reindex:

./scripts/skill_search.py index