Agent Skills › espressif/esp-claw › skills_lab_search

skills_lab_search

GitHub

用于在ESP-Claw技能中心通过关键词和高级过滤器搜索技能，并引导用户下载所选技能。

components/common/skill_builder/skills/skills_lab_search/SKILL.md espressif/esp-claw

Trigger Scenarios

用户希望从ESP-Claw技能中心搜索或发现技能用户提供主题、功能、外设、标签或类别以匹配候选技能用户不知道安装技能所需的精确skill id

Install

npx skills add espressif/esp-claw --skill skills_lab_search -g -y

More Options

Non-standard path

npx skills add https://github.com/espressif/esp-claw/tree/master/components/common/skill_builder/skills/skills_lab_search -g -y

Use without installing

npx skills use espressif/esp-claw@skills_lab_search

指定 Agent (Claude Code)

npx skills add espressif/esp-claw --skill skills_lab_search -a claude-code -g -y

安装 repo 全部 skill

npx skills add espressif/esp-claw --all -g -y

预览 repo 内 skill

npx skills add espressif/esp-claw --list

SKILL.md

Frontmatter

{
    "name": "skills_lab_search",
    "metadata": {
        "cap_groups": [
            "cap_http_request",
            "cap_boards"
        ],
        "manage_mode": "web"
    },
    "description": "Search skills from the ESP-Skill hub by keywords and advanced filters, then guide the user to download a selected skill with skills_lab_downloader."
}

Skills Lab Search

Use this skill when the user wants to search or discover skills from the ESP-Claw's Skill hub.

When to use

The user wants to search for skills from the ESP-Claw's Skill hub.
The user provides a topic, feature, peripheral, tag, or category and wants matching skill candidates.
The user does not know the exact skill id needed by skills_lab_downloader.

Hard rules

Before searching, make sure cap_web_search is enabled and available. If it is unavailable, stop and tell the user to enable web search first.
Prefer English keywords for better search results unless the user provides a specific query.
Always URL encode the full query string before appending it to https://skills-lab.esp-claw.com/api/search?q=.
Use the search API endpoint directly. Do not scrape the web UI page for results.
If the user asks which tags, peripherals, or categories are available, fetch https://skills-lab.esp-claw.com/raw/tags.json and summarize the relevant values.
Preserve advanced search syntax exactly before URL encoding: t:"tag", p:"peripheral", and c:"category".
Use featured=true when the user wants to filter results to featured skills only.
If the user asks to list all available skills, request featured skills only with featured=true and no q parameter, present those featured skills, and ask the user for more specific search criteria.
After presenting results, remind the user that installation requires the exact skill id and can be done with skills_lab_downloader.

Search syntax

Free text keywords: bilibili fans
Tag filter: t:"info"
Peripheral filter: p:"display"
Category filter: c:"utility"
Filters can be combined with free text keywords: bilibili fans t:"info"
A filter-only query is valid: t:"info"
Featured-only filter: featured=true

Available tag, peripheral, and category values can be checked at:

https://skills-lab.esp-claw.com/raw/tags.json

Workflow

If the user asks to list all available skills, request featured skills only with no q parameter:

https://skills-lab.esp-claw.com/api/search?featured=true

Present the featured skill results, then ask the user for more specific search criteria before doing a broader search.
Ask for search keywords if the user did not provide any searchable terms, filters, or a request for featured skills.
Build a search query with English keywords when possible.
Include advanced filters only when the user asks for them or when they are clearly implied.
Add featured=true when the user wants featured skills only.
URL encode the complete q query value when q is used.
Request the search API:

https://skills-lab.esp-claw.com/api/search?q=<url_encoded_query>

When using both q and featured=true, request:

https://skills-lab.esp-claw.com/api/search?q=<url_encoded_query>&featured=true

Read the returned search results and present the best matches with exact skill ids, titles, and short descriptions when available.
If there are no results, suggest a broader query, fewer filters, or checking available values from tags.json.
If the user chooses a skill to install, activate skills_lab_downloader and pass the exact skill id(name).

Examples

Query: bilibili fans

https://skills-lab.esp-claw.com/api/search?q=bilibili+fans

Query: bilibili fans t:"info"

https://skills-lab.esp-claw.com/api/search?q=bilibili+fans+t%3A%22info%22

Query: t:"info"

https://skills-lab.esp-claw.com/api/search?q=t%3A%22info%22

Query: t:"info" quote

https://skills-lab.esp-claw.com/api/search?q=t%3A%22info%22+quote

Featured-only query: bilibili fans

https://skills-lab.esp-claw.com/api/search?q=bilibili+fans&featured=true

List featured skills:

https://skills-lab.esp-claw.com/api/search?featured=true

Notes

Search results are only candidates. Do not install a result until the user selects the exact skill id.
Do not guess a skill id from a visible title. Use the exact skill id returned by the search API.
skills_lab_downloader handles metadata checks, peripheral compatibility, and installation.