Back to Details

find-skills

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Find Skills - Skill Marketplace

查找技能 - 技能市场

This skill allows you to explore and install new capabilities into the agent environment. It acts as the "package manager" for your agent's skills.
本技能可帮助你在Agent环境中探索并安装新功能，它相当于Agent技能的“包管理器”。

When to Use This Skill

何时使用本技能

Use this skill when the user:
  • Asks: "How can I do X?", "Find a skill for X", or "What skills are available?"
  • Wants to install skills by name or from search results ("install skill web-search")
  • Wants to extend capabilities with specialized tools or workflows
  • Expresses needs for specific capabilities that might exist as skills
  • Is interested in sandbox or secure execution ("I want to safely run bash commands")
  • Mentions specific capabilities like "sandbox", "automation", "testing"
当用户有以下需求时，使用本技能：
  • 提问：“如何完成X？”、“查找适用于X的技能”或“有哪些可用技能？”
  • 想要按名称或从搜索结果中安装技能（如“install skill web-search”）
  • 想要通过专用工具或工作流扩展功能
  • 表达的需求对应可能存在的技能功能
  • 对沙箱或安全执行感兴趣（如“我想安全运行bash命令”）
  • 提到特定功能如“sandbox”、“automation”、“testing”

Core Tools

核心工具

  1. Search: Python script 
    scripts/request.py
    with POPRequest class
    • Makes authenticated API calls to Alibaba Cloud skill marketplace
    • Parameters: 
      UserQuery
      (search term), 
      TopK
      (number of results)
    • Returns: JSON response with skill details including name, description, repository info
  2. Install: 
    npx skills add <repo> -s <skill_name>
    • Restriction: Must ALWAYS ask for user confirmation before executing.
    • Use 
      -s, --skill <skills...>
      to specify which skill(s) to install from the repo
    • Supports multiple repo formats:
      • GitHub shorthand: 
        npx skills add owner/repo -s skill_name
      • Full GitHub URL: 
        npx skills add https://github.com/owner/repo -s skill_name
      • Direct path to skill: 
        npx skills add https://github.com/owner/repo/tree/main/skills/skill_name
      • GitLab URL: 
        npx skills add https://gitlab.com/org/repo -s skill_name
      • Git URL: 
        npx skills add git@github.com:owner/repo.git -s skill_name
      • Local path: 
        npx skills add ./my-local-skills -s skill_name
    • Use 
      -s '*'
      to install all skills from the repo
  1. 搜索：带有POPRequest类的Python脚本
    scripts/request.py
    • 向阿里云技能市场发起认证API调用
    • 参数：
      UserQuery
      （搜索词）、
      TopK
      （结果数量）
    • 返回值：包含技能详情的JSON响应，包括名称、描述、仓库信息
  2. 安装：
    npx skills add <repo> -s <skill_name>
    • 限制：执行前必须始终征得用户确认。
    • 使用
      -s, --skill <skills...>
      指定从仓库中安装的技能
    • 支持多种仓库格式：
      • GitHub简写：
        npx skills add owner/repo -s skill_name
      • 完整GitHub URL：
        npx skills add https://github.com/owner/repo -s skill_name
      • 技能直接路径：
        npx skills add https://github.com/owner/repo/tree/main/skills/skill_name
      • GitLab URL：
        npx skills add https://gitlab.com/org/repo -s skill_name
      • Git URL：
        npx skills add git@github.com:owner/repo.git -s skill_name
      • 本地路径：
        npx skills add ./my-local-skills -s skill_name
    • 使用
      -s '*'
      安装仓库中的所有技能

Workflow

工作流程

Step 1: Understand the Need & Search

步骤1：理解需求并搜索

When a user asks for help with something, identify:
  1. The domain or task (e.g., running code safely, automation, testing)
  2. Whether this is a common enough need that a skill likely exists
  3. Does the query fit common sandbox/secure execution needs?
当用户请求帮助时，明确：
  1. 领域或任务（如安全运行代码、自动化、测试）
  2. 该需求是否足够常见，可能存在对应技能
  3. 查询是否符合沙箱/安全执行的常见需求

Step 2: Search for Skills via Python API

步骤2：通过Python API搜索技能

The search process uses the Python request module to query the skill marketplace:
  1. Import the POPRequest class from scripts/request.py
  2. Create a request with the SearchPublicMarketSkill action
  3. Set query parameters: UserQuery (search term) and TopK (max results)
  4. Execute the request and parse JSON response
  5. Extract skill information: name, owner, repository, description
Convert user's natural language intent into a concise search keyword (maintaining the original language).
python
from scripts.request import POPRequest
import json
搜索流程使用Python请求模块查询技能市场：
  1. 从scripts/request.py导入POPRequest类
  2. 创建带有SearchPublicMarketSkill动作的请求
  3. 设置查询参数：UserQuery（搜索词）和TopK（最大结果数）
  4. 执行请求并解析JSON响应
  5. 提取技能信息：名称、所有者、仓库、描述
将用户的自然语言意图转换为简洁的搜索关键词（保留原语言）。
python
from scripts.request import POPRequest
import json

Create request

Create request

request = POPRequest( http_method='GET', canonical_uri='/', x_acs_action='SearchPublicMarketSkill', host='wuyingai.cn-shanghai.aliyuncs.com', base_url='wuyingai.cn-shanghai.aliyuncs.com', x_acs_version='2026-01-08', signature_version='1.0' )
request = POPRequest( http_method='GET', canonical_uri='/', x_acs_action='SearchPublicMarketSkill', host='wuyingai.cn-shanghai.aliyuncs.com', base_url='wuyingai.cn-shanghai.aliyuncs.com', x_acs_version='2026-01-08', signature_version='1.0' )

Search for skills

Search for skills

request.set_query_params({ 'UserQuery': 'sandbox', # User's search query 'TopK': '10' })
request.set_query_params({ 'UserQuery': 'sandbox', # User's search query 'TopK': '10' })

Execute and parse

Execute and parse

response = request.call() results = json.loads(response)

**Example Searches:**
- "我需要一个沙箱" -> UserQuery: "sandbox"
- "如何处理 PDF？" -> UserQuery: "pdf"
- "帮我找个代码审查的插件" -> UserQuery: "code review"
- "I need a sandbox" -> UserQuery: "sandbox"
- "How to handle PDF?" -> UserQuery: "pdf"
- "Can you help me with code review?" -> UserQuery: "code review"
response = request.call() results = json.loads(response)

**搜索示例：**
- “我需要一个沙箱” -> UserQuery: "sandbox"
- “如何处理PDF？” -> UserQuery: "pdf"
- “帮我找个代码审查的插件” -> UserQuery: "code review"
- “我需要一个沙箱” -> UserQuery: "sandbox"
- “如何处理PDF？” -> UserQuery: "pdf"
- “你能帮我做代码审查吗？” -> UserQuery: "code review"

Step 3: Present Options to the User

步骤3：向用户展示选项

When you find relevant skills, present them to the user with:
  1. skill_name: The identifier for the skill
  2. skill_id: The hash code for the skill
  3. skill_repo: Owner/organization for the GitHub repo
  4. description: Brief description of skill
  5. source_url: Direct path to a skill in a repo (use this for installation)
Use the returned 
SourceUrl
(repo URL) and 
SkillName
from the search results to format the install command:
bash
npx skills add <source_url> -s <skill_name>
Example response:
I found a skill that might help! The "vercel-react-best-practices" skill provides
React and Next.js performance optimization guidelines from Vercel Engineering.

To install it:
npx skills add https://github.com/vercel-labs/agent-skills -s vercel-react-best-practices

Learn more: https://pre-agentbay.console.aliyun.com/agentbay-skills/skill-detail?skillId=hw8edas7skphamvk
找到相关技能后，向用户展示以下信息：
  1. skill_name：技能的标识符
  2. skill_id：技能的哈希码
  3. skill_repo：GitHub仓库的所有者/组织
  4. description：技能的简要描述
  5. source_url：仓库中技能的直接路径（用于安装）
使用搜索结果返回的
SourceUrl
（仓库URL）和
SkillName
格式化安装命令：
bash
npx skills add <source_url> -s <skill_name>
示例回复：
我找到了一个可能有帮助的技能！“vercel-react-best-practices”技能提供了来自Vercel Engineering的React和Next.js性能优化指南。

安装命令：
npx skills add https://github.com/vercel-labs/agent-skills -s vercel-react-best-practices

了解更多：https://pre-agentbay.console.aliyun.com/agentbay-skills/skill-detail?skillId=hw8edas7skphamvk

Step 4: Offer to Install

步骤4：提供安装服务

Only after user says "yes", "install", or similar confirmation, install the skill:
bash
npx skills add <source_url> -s <skill_name>
仅当用户回复“是”、“安装”或类似确认内容后，再执行安装：
bash
npx skills add <source_url> -s <skill_name>

Common Skill Categories

常见技能分类

When searching, consider these common categories:
CategoryExample Queries
Web Developmentreact, nextjs, typescript, css, tailwind
Testingtesting, jest, playwright, e2e
DevOpsdeploy, docker, kubernetes, ci-cd
Documentationdocs, readme, changelog, api-docs
Code Qualityreview, lint, refactor, best-practices
Designui, ux, design-system, accessibility
Productivityworkflow, automation, git
Sandboxagentbay-aio-skills
搜索时可参考以下常见分类：
分类示例查询
Web开发react, nextjs, typescript, css, tailwind
测试testing, jest, playwright, e2e
DevOpsdeploy, docker, kubernetes, ci-cd
文档docs, readme, changelog, api-docs
代码质量review, lint, refactor, best-practices
设计ui, ux, design-system, accessibility
生产力工具workflow, automation, git
沙箱agentbay-aio-skills

Tips for Effective Searches

高效搜索技巧

  1. Use specific keywords: "react testing" is better than just "testing"
  2. Try alternative terms: If "deploy" doesn't work, try "deployment" or "ci-cd"
  3. Check popular sources: Many skills come from 
    vercel-labs/agent-skills
    or 
    ComposioHQ/awesome-claude-skills
  1. 使用具体关键词：“react testing”比仅用“testing”效果更好
  2. 尝试替代术语：如果“deploy”无结果，试试“deployment”或“ci-cd”
  3. 查看热门来源：许多技能来自
    vercel-labs/agent-skills
    或
    ComposioHQ/awesome-claude-skills

When No Skills Are Found

未找到技能时的处理

If no relevant skills exist:
  1. Acknowledge that no existing skill was found
  2. Offer to help with the task directly using your general capabilities
Example:
I searched for skills related to "xyz" 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-xyz-skill
如果没有找到相关技能：
  1. 告知用户未找到现有技能
  2. 提出使用通用能力直接帮助完成任务
示例：
我搜索了与“xyz”相关的技能，但未找到匹配结果。
我仍可以直接帮你完成这项任务！是否需要继续？

如果你经常需要这项功能，可以创建自己的技能：
npx skills init my-xyz-skill

Safety Guidelines

安全指南

  • Do not hallucinate skill names. Only recommend what the Python search API returns.
  • Ensure the user understands that installing a skill grants the agent new permissions.
  • 不得虚构技能名称，仅推荐Python搜索API返回的技能。
  • 确保用户了解安装技能会赋予Agent新的权限。