Skills Lab Search
Apps & Automationskills_lab_searchSkills Lab Search is an Agent Skill for apps & automation published in the espressif/esp-claw repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
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.
QUICK START
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/espressif/esp-claw/blob/HEAD/components/common/skill_builder/skills/skills_lab_search/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/skills-lab-search, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
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_searchis 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.jsonand summarize the relevant values. - Preserve advanced search syntax exactly before URL encoding:
t:"tag",p:"peripheral", andc:"category". - Use
featured=truewhen 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=trueand noqparameter, 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
qparameter:
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=truewhen the user wants featured skills only. - URL encode the complete
qquery value whenqis used. - Request the search API:
https://skills-lab.esp-claw.com/api/search?q=<url_encoded_query>
- When using both
qandfeatured=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_downloaderand 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_downloaderhandles metadata checks, peripheral compatibility, and installation.