← 返回 Skills 市场
at6132

Skill Search

作者 at6132 · GitHub ↗ · v1.1.0
cross-platform ✓ 安全检测通过
650
总下载
0
收藏
3
当前安装
2
版本数
在 OpenClaw 中安装
/install fitcheck-skill-search
功能描述
Find and retrieve available skills using keyword search, semantic search, or LLM-powered task matching. Use when the agent needs to discover, search, or inte...
使用说明 (SKILL.md)

Skill Search V1.1

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

Overview

This skill provides three search modes:

  1. Keyword Search (Fast BM25) — Match skill names and descriptions
  2. Semantic Search (Embeddings) — Find skills by meaning/concept similarity
  3. 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

  1. Search: Find skills matching your need (keyword/semantic/LLM)
  2. Preview: Read SKILL.md metadata (description, triggers)
  3. 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

Resources

scripts/

  • skill_search.py — Main search interface (keyword/semantic/LLM)
  • indexer.py — Build/update search index
  • embeddings.py — Embedding generation (local miniLM)

index/

  • skills_index.json — Searchable skill metadata
  • embeddings_cache.json — Pre-computed embeddings for semantic search
安全使用建议
This skill is coherent for discovering other skills and builds a local index by reading SKILL.md files from both system and user skill directories. Before installing, review the SKILL.md files in your skills folders (and any existing index file ~/.openclaw/workspace/skills/skill-search/index/) to ensure they don't contain secrets or sensitive strings you don't want indexed. Because the index is stored locally, treat the index file like any other potentially sensitive artifact. If you prefer not to let an agent autonomously index system skills, keep the skill user-invoked only or remove system skill paths from SKILL_DIRS before running.
功能分析
Type: OpenClaw Skill Name: fitcheck-skill-search Version: 1.1.0 The OpenClaw AgentSkills skill bundle 'fitcheck-skill-search' is classified as benign. The skill's purpose is to locally search and retrieve other available skills. It operates entirely on local file system paths (`/usr/local/lib/node_modules/openclaw/skills`, `~/.openclaw/workspace/skills`) to read `SKILL.md` files and build a local search index (`index/skills_index.json`). The `scripts/embeddings.py` explicitly uses a simple, local `fallback_embedding` function, avoiding external API calls or complex ML model loading, which is a positive security practice. There is no evidence of data exfiltration, malicious execution, persistence mechanisms, or prompt injection attempts against the agent in any of the analyzed files.
能力评估
Purpose & Capability
Name/description (skill discovery/search) match what the code and SKILL.md do: parsing SKILL.md frontmatter, listing skills from system and user skill directories, and performing keyword/semantic/hybrid searches. There are no unrelated credentials, binaries, or heavyweight external dependencies.
Instruction Scope
The runtime instructions and scripts read SKILL.md files from both user (~/.openclaw/workspace/skills) and system (/usr/local/lib/node_modules/openclaw/skills) locations and build a local index. This is expected for a skill indexer, but it means the skill will read the contents (and some metadata) of other skills — if any SKILL.md contains sensitive data, that data will be included in the local index.
Install Mechanism
No install spec; this is instruction/code-only and writes only to its own index directory under the skill folder. No downloads or external installers are used.
Credentials
No environment variables, external API keys, or unrelated credentials are requested. Embedding generation is local/fallback; the code does not require cloud API keys.
Persistence & Privilege
always:false and no code that modifies other skills or global agent config. It creates/updates a local index under its own index folder (expected). Autonomous invocation is enabled by default but is not excessive here given the skill's purpose.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install fitcheck-skill-search
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /fitcheck-skill-search 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.1.0
V1.1: Added semantic search, hybrid scoring, and AI-powered task matching. Uses local char n-gram embeddings (384d). Hybrid search combines keyword (BM25-style) and semantic scores 50/50. New suggest command with confidence ratings (High/Medium/Low). Enhanced keyword scoring: exact match +20, name contains +10, triggers +3.
v1.0.0
Initial release: search available skills without loading them all into context
元数据
Slug fitcheck-skill-search
版本 1.1.0
许可证
累计安装 3
当前安装数 3
历史版本数 2
常见问题

Skill Search 是什么?

Find and retrieve available skills using keyword search, semantic search, or LLM-powered task matching. Use when the agent needs to discover, search, or inte... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 650 次。

如何安装 Skill Search?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install fitcheck-skill-search」即可一键安装,无需额外配置。

Skill Search 是免费的吗?

是的,Skill Search 完全免费(开源免费),可自由下载、安装和使用。

Skill Search 支持哪些平台?

Skill Search 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 Skill Search?

由 at6132(@at6132)开发并维护,当前版本 v1.1.0。

💬 留言讨论