find-skills
Do NOT invoke this skill as a routine first step. Do NOT invoke when any installed skill (see the available skills list) can handle the task, or when general capabilities (writing, coding, analysis, t
SKILL.mdqwenwork/skills/find-skills/SKILL.md
GitHubFind Skills
This is a unified skill discovery & installation orchestration skill. It searches two mandatory sources — the official QwenWork marketplace (skills) and the skills.sh community skill library — plus an optional enterprise source (Enterprise Skill Market MCP, if available) — and merges results into a single search-and-install flow, with mandatory user confirmation before any installation.
CORE PRINCIPLE: Every invocation of this skill MUST search both the official marketplace AND skills.sh community. Additionally, if any Enterprise Skill Market MCP is available and exposes a
searchSkills(or similar skill search) tool, it MUST also be searched. These are independent channels with different coverage — the marketplace offers curated quality skills, skills.sh covers niche domains and newer tools, and the enterprise source provides organization-specific curated skills. Searching only one mandatory source is an incomplete search. Do not present results to the user until all applicable sources have been queried.
Decision Gate: Answer These Before Invoking
Before invoking this skill, answer ALL three questions. If ANY answer is "no", do NOT invoke — handle the task directly instead:
- No installed skill covers it? Check the available skills list (builtin + user-installed, including skills bundled by plugins/expert suites). If any installed skill can handle the task, use that skill directly — never search for a replacement.
- Would general capabilities be clearly worse? If writing, coding, analysis, translation, or web search can complete the task at acceptable quality, do it directly.
- Does the user actually need a dedicated skill? The request must call for a reusable specialized capability (e.g. a specialized file format, a vertical platform workflow), not a one-off answer.
User explicitly asking to find/install/browse skills or the marketplace always passes the gate.
Priority: Local Skills First, Search Only as Fallback
CRITICAL: Installed skills always take priority. Searching is a fallback, not a default step.
The correct behavior is:
- User asks for help with a task
- Step 0: Check the installed skills list (builtin + user-installed). If a suitable skill exists, use it directly and do NOT invoke this skill
- Only when Step 0 finds nothing suitable AND the task very likely needs a dedicated skill: search — execute BOTH mandatory searches: ① official marketplace search ②
npx skills findon skills.sh - Present results from all available sources to user via
AskUserQuestion - Install the chosen skill
- THEN: Use the installed skill to fulfill the user's original request
Before You Begin: User Confirmation Rule
IMPORTANT: Never install any skill without explicit user confirmation.
After searching, you MUST call the AskUserQuestion tool to present ALL search results to the user. The AskUserQuestion tool provides a structured UI for the user to review and select which item(s) to install — this is the ONLY acceptable way to obtain user confirmation.
DO NOT skip this step. DO NOT assume the user wants to install anything automatically. DO NOT use plain text messages as a substitute for AskUserQuestion.
The correct workflow is:
- Search — collect results from all sources
- MANDATORY: Call
AskUserQuestiontool — list each found skill as an option with name, description, and source. Let the user select which one(s) to install. - Only after user explicitly selects via
AskUserQuestion— call the corresponding install tool
When to Use This Skill
Use this skill ONLY when the user:
- Says "find a skill for X" or "is there a skill for X"
- Explicitly asks to install a specific skill or browse/search the skill marketplace
- Expresses interest in extending agent capabilities with new skills
- Has a task that no installed skill covers AND that very likely needs a dedicated skill to be done well (e.g. a specialized file format, a vertical platform workflow)
When NOT to Use This Skill
- Any installed skill (builtin, user-installed, or bundled by a plugin/expert suite) can handle the task — use it directly
- General capabilities (writing, coding, analysis, translation, web search) can complete the task at acceptable quality
- Pure chitchat or factual questions
- The user did not ask for new capabilities — do not proactively pitch skill installation as a detour from their task
Remember: A wrong search interrupt costs more than a slightly suboptimal direct answer — when in doubt, do the task with installed capabilities instead of invoking this skill.
Search Flow
When the user triggers a search, you MUST query both mandatory sources to provide comprehensive results.
Keyword Extraction (Critical)
The official marketplace uses simple substring matching — the entire keyword parameter is matched as a single string against name, nameCn, description, descriptionCn. It does NOT split on spaces, does NOT support multiple keywords in one query, and does NOT support semantic search.
IMPORTANT: Each search call accepts only ONE keyword. Do NOT concatenate multiple terms into a single string like
"resume CV 简历"— this will fail because no skill contains that exact substring. Instead, pick the single most relevant keyword per call, or make multiple calls with different keywords.
Before searching, you MUST extract concise, relevant keywords from the user's intent:
| User says | ❌ Wrong (multi-term string) | ✅ Correct (one keyword per call) |
|---|---|---|
| "帮我写一份简历" | "resume CV 简历" |
"resume" or "简历" (separate calls) |
| "help me deploy to cloud" | "deploy cloud app" |
"deploy" or "cloudflare" |
| "can you review my PR" | "review pull request code" |
"review" or "pr" |
| "帮我做一个PPT" | "ppt 演示 文档" |
"ppt" or "演示" |
| "我想用AI分析这份报告" | "AI分析报告" |
"数据分析" or "report" |
Keyword extraction rules:
- ONE keyword per search call — the
keywordparameter is matched as a whole string, not split by spaces - Pick the single most relevant domain term (e.g.,
"resume"not"resume writing help") - If the first keyword returns no results, try an alternative keyword in a second call (e.g., try
"简历"after"resume"finds nothing) - For bilingual coverage: make one call with English keyword, one with Chinese keyword
- For skills.sh (
npx skills find), use English keywords only
Source A: Official Marketplace (via qw MCP)
Search the unified marketplace:
mcp__qw-builtin__qw_query({
key: "qwenwork.settings.skills.market",
params: {
keyword: "<extracted-keyword>",
category: "<optional>",
page: <optional>
}
})
All parameters are optional. page supports pagination, page size is fixed at 10.
Response format:
- Returns:
{ success, data: { skills[], totalSize, currentPage, pageSize, hasMore } }— each skill includesid(skill identifier / folderName, used asfolderNamewhen installing),name,nameCn,description,descriptionCn,version,installed,category,installCount.
Source B: skills.sh Community Skill Library (EQUALLY REQUIRED)
The skills.sh community search is NOT a supplement to the marketplace — it is an independent, equally mandatory search channel. Community skills often cover niche use cases, newer tools, and specialized workflows that the curated marketplace has not yet included.
Search method:
Run the find command with a relevant query:
npx skills find [query]
This searches the community skill ecosystem at skills.sh.
For example:
- User asks "how do I make my React app faster?" →
npx skills find react performance - User asks "can you help me with PR reviews?" →
npx skills find pr review - User asks "I need to create a changelog" →
npx skills find changelog
The command will return results like:
Install with npx skills add <owner/repo@skill>
vercel-labs/agent-skills@vercel-react-best-practices
└ https://skills.sh/vercel-labs/agent-skills/vercel-react-best-practices
Browse skills at: https://skills.sh/
Source C: Enterprise Skill Market MCP (Optional — Auto-detected)
This source is conditionally activated. Before searching, you need to dynamically detect whether any enterprise MCP service with skill search capabilities exists in the current session, rather than relying on any hardcoded service name.
Activation check (detailed steps):
- Call
qwenwork_mcp_tool_listto view all currently available MCP tools - In the returned tool list, look for any tool whose name contains
searchSkillor similar skill search functionality (e.g.,mcp__<any-mcp-name>__searchSkills) - If a matching tool is found, call
qwenwork_mcp_tool_getto get the tool's detailed parameter schema and confirm it accepts search parameters likekeyword - If confirmed → this source is enabled, proceed with the search below
- If NO matching tool found → skip this source entirely (do not error, do not warn)
Note: Do not hardcode any specific MCP service name. Use the dynamic detection flow described above to automatically discover any MCP service that provides the
searchSkillscapability.
Search method:
Call the detected enterprise MCP's searchSkills tool (use the actually detected tool name):
mcp__<detected-mcp-name>__searchSkills({
keyword: "<extracted-keyword>"
})
The tool returns a list of skills with fields such as name, description, downloadUrl, source, and other metadata.
Key differences from other sources:
- This source is optional — only activate when the MCP and tool are detected
- Results from this source should be tagged as Enterprise Skill in the presentation
- Installation uses a different method (download + extract, not marketplace API or CLI)
Search Strategy
- Two mandatory steps + one conditional step: 1️⃣ Search official marketplace (required), 2️⃣ Search skills.sh (required), 3️⃣ Search Enterprise Skill Market MCP (only if available). The search is NOT complete until both mandatory steps have been executed and the conditional step has been attempted. Do not proceed to presenting results until all applicable searches are done.
- Why all sources matter: The marketplace has curated, high-quality skills; skills.sh has community-contributed skills covering niche domains, newer tools, and specialized workflows. They serve different purposes and have different coverage — searching only one mandatory source means missing potential solutions.
- Extract the most relevant keyword(s) from the user's request before searching.
- Combine and deduplicate results from all available sources before presenting to the user.
- If one source returns no results, still present results from the other source.
Present Results and Confirm
IMPORTANT: Before executing ANY installation, you MUST use
AskUserQuestionto present search results and get explicit user authorization. Never install without user confirmation.
After collecting results from all sources, present them in a unified list using AskUserQuestion, clearly distinguishing the source of each result:
AskUserQuestion({
questions: [{
question: "I found the following skills matching your request. Which would you like to install?",
header: "Install",
options: [
{
label: "<skill-name> (Official Skill)",
description: "<brief-description> — Install count: <N> — ready to install"
},
{
label: "<skill-name> (Enterprise Skill)",
description: "<brief-description> — from Enterprise Skill Market"
},
{
label: "<repo@skill-name> (Community - skills.sh)",
description: "<brief-description> — from skills.sh"
}
]
}]
})
Presentation rules:
- Results from ALL sources MUST be presented — never omit community results just because official results exist. The user deserves to see the full picture.
- Each option MUST be clearly tagged with its source: Official Skill or Community - skills.sh
- Ordering: Official marketplace results listed first, then Enterprise Skill results (if any), then community skills.sh results. This is a SORT ORDER, not a filter — all sources with results must appear.
- Include install count for official skills when available
- Include brief descriptions to help users make informed choices
- Do NOT manually add a "don't install" or "skip" option —
AskUserQuestionautomatically provides an "Other" option for users who want to decline or type a custom response. - If the user chooses "Other" to decline, end gracefully and offer to help directly with the task.
Result selection constraints (MANDATORY):
- Total recommendations MUST NOT exceed 4 — regardless of how many results are returned across all sources, present at most 4 options to the user via
AskUserQuestion. - Prioritize diversity across sources: pick 1-2 most relevant results from EACH source that returned matches. For example: 1-2 official marketplace results + 1 enterprise result (if available) + 1-2 community skills.sh results, with the total capped at 4.
- Allocate slots fairly: at least 1 slot for each source that returned results, so the user sees coverage from all channels.
- If one source has many more results, briefly mention in the question text: "(N more results available from skills.sh — select Other to see more)"
- Do NOT dump all results into the options list — curate the most relevant subset to keep the selection concise and actionable.
Installation
After the user confirms their choice, execute the appropriate installation based on the item type.
Official Skill Installation
IMPORTANT: Always obtain user confirmation via
AskUserQuestionbefore calling this tool.
The folderName parameter should be the skill's id from the search results. This id is the skill's folder name identifier.
mcp__qw-builtin__qw_action({
key: "qwenwork.settings.skills.market",
action: "execute",
params: {
operation: "install",
folderName: "<skill-id-from-search-results>"
}
})
Example: if search returns a skill with id: "deep-research" and name: "deep-research", use folderName: "deep-research".
Response: { success, message, data: { folderName, version, fromCache } }
Community Skill Installation
IMPORTANT: Always obtain user confirmation via
AskUserQuestionbefore calling this tool.
There are multiple approaches depending on the skill's availability:
Approach 1: If the skill is also available in the official marketplace, use install_skill for a streamlined installation.
Approach 2: Install via CLI (npx skills):
npx skills add <owner/repo@skill> -g -y
The -g flag installs globally to ~/.agents/skills and -y skips confirmation prompts.
After installation, create links to make the skill available in QwenWork:
For regular environments (symbolic links):
ln -sf ~/.agents/skills/<skill-name> ~/.qwenworkcn/skills/<skill-name>
For virtual machine environments (copy files):
cp -r ~/.agents/skills/<skill-name> ~/.qwenworkcn/skills/<skill-name>
Tips for skills.sh discoveries:
- Check the skill page on skills.sh for installation instructions and configuration details
- After installation, verify the skill is available and working correctly
Enterprise Skill Installation (Agent-Executed)
IMPORTANT: Always obtain user confirmation via
AskUserQuestionbefore proceeding with installation.
When the user selects a skill from the Enterprise Skill Market source, the agent performs the installation directly. The searchSkills result provides downloadUrl and skillName (used as folder name).
Installation target directory: ~/.qwenworkcn/skills/<skillName>/
Installation Script
The find-skills skill ships with dedicated installation scripts located in its own scripts/ subdirectory. These scripts encapsulate the full installation flow: downloading the ZIP package, extracting, validating SKILL.md presence, backing up the existing version (if any), installing to the target directory, verifying, and cleaning up temporary files.
The agent only needs to invoke the appropriate script with the skill name and download URL. No inline multi-step commands are required.
Platform-Specific Invocation
Detect the user's operating system first, then call the corresponding script.
macOS / Linux (Bash/Zsh):
bash ~/.qwenworkcn/skills/find-skills/scripts/install-skill.sh --name "<skillName>" --url "<downloadUrl>"
Windows:
powershell.exe -ExecutionPolicy Bypass -NoProfile -File "$HOME\.qwenworkcn\skills\find-skills\scripts\install-skill.ps1" -Name "<skillName>" -Url "<downloadUrl>"
This command works from any shell (CMD, PowerShell, or Bash/Git Bash on Windows). The -ExecutionPolicy Bypass flag is already included, so no additional configuration is needed.
Script Parameters
| Parameter | Required | Description |
|---|---|---|
--name / -Name |
Yes | The skill's folder name (from skillName in search results) |
--url / -Url |
Yes | The download URL for the skill ZIP package (from downloadUrl in search results) |
--target-dir / -TargetDir |
No | Override the active product's skills directory (~/.qwenworkcn/skills). Rarely needed. |
What the Script Does Internally
- Downloads the ZIP from the provided URL (follows redirects)
- Extracts to a temporary directory
- Validates the package contains a
SKILL.mdfile (ignores__MACOSXand hidden files) - Locates the skill root (the directory directly containing
SKILL.md) - Backs up the existing version if
~/.qwenworkcn/skills/<skillName>already exists - Installs the skill to
~/.qwenworkcn/skills/<skillName>/ - Verifies that
SKILL.mdis readable at the install path - Cleans up all temporary files
The script prints status messages and exits with code 0 on success or non-zero on failure.
Error Handling
| Error | Action |
|---|---|
| Download fails (network error, 404, auth required) | Inform user, suggest checking network or retrying |
| ZIP extraction fails | Inform user the package may be corrupted |
| SKILL.md not found in package | Inform user the package is invalid, not a valid skill |
| Move/copy fails (permission denied) | Inform user, suggest checking directory permissions |
| Any failure | Always clean up temporary files before reporting the error |
Success
After successful installation, confirm to the user:
- Skill name and install path
- The skill is immediately available for use (no session restart needed)
- Proceed to the Post-Installation: Immediate Activation section to invoke the skill if applicable
Post-Installation: Immediate Activation
Key point: After installation, the skill is immediately available — no need to start a new session.
This works because QoderCLI's GetSkill(name) method performs a real-time disk scan on every invocation. Once the skill files are written to disk, the current session can discover and load them via the Skill tool.
Follow this sequence after successful installation:
- If the user's original request can be served by the newly installed skill, immediately invoke it:
Skill({ skill: "<installed-skill-name>" }) - Pass the user's original request as
argsif applicable:Skill({ skill: "<installed-skill-name>", args: "<user-original-request>" }) - Inform the user that the skill has been installed and is being activated now.
Note: The newly installed skill will NOT appear in the
<available_skills>list (that list is built only at session initialization). However, theSkilltool's runtime lookup performs a live disk scan, so it can find and load the skill regardless. Do not be confused by its absence from the available skills list.
Common Skill Categories
When searching, consider these common categories to help extract better keywords:
| Category | Example Queries |
|---|---|
| Web Development | react, nextjs, typescript, css, tailwind |
| Testing | testing, jest, playwright, e2e |
| DevOps | deploy, docker, kubernetes, ci-cd |
| Documentation | docs, readme, changelog, api-docs |
| Code Quality | review, lint, refactor, best-practices |
| Design | ui, ux, design-system, accessibility |
| Productivity | workflow, automation, git |
| Data Analysis | data, sql, analytics, visualization |
When No Results Are Found
If all sources return no matching results:
- Inform the user that no existing skills were found for their query
- Offer to help with the task directly using your general capabilities
- Suggest the user could create their own skill:
I searched the official marketplace and community ecosystem for "<query>" but didn't find any matches.
I can still help you with this task directly! Would you like me to proceed?
If this is something you do often, you could create your own skill:
npx skills init my-custom-skill
Important Rules
- Search is a two-step mandatory checklist + one conditional step (marketplace + skills.sh + enterprise MCP if available) — Both mandatory steps must be executed on every invocation. The enterprise MCP step is conditional — only execute if the MCP and its
searchSkillstool are detected. A search that only covers one mandatory source is incomplete. Do not present results or proceed until all applicable searches are done. - Always present results from ALL sources that returned matches — "Official first, then Community" is sort order only, NOT filtering. If any source returned results, they MUST appear in the options.
- Always use AskUserQuestion before installing — This is a mandatory step. Present results and wait for explicit user confirmation.
- Never install without explicit user confirmation — Under no circumstances should you skip the confirmation step and proceed to install directly.
- Do NOT add a manual "skip/decline" option —
AskUserQuestionautomatically provides "Other" for this purpose. Use all available option slots for actual search results. - Immediately activate after installation — Once installation succeeds, invoke the skill via the
Skilltool if the user's original request can be served by it. Do not ask the user to start a new session. - Handle errors gracefully — If an installation fails, inform the user of the error, suggest alternatives (try another result, manual installation, or direct help), and do not leave the conversation in a broken state.