discover-skills

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Skill: Discover Skills

Skill: 技能发现

Purpose

用途

Help the Agent identify missing skills for a task and recommend concrete installation steps. This skill discovers candidates and suggests what to install, but does not install or inject skills automatically.

帮助Agent识别完成任务所需的缺失Skill，并推荐具体的安装步骤。该Skill会寻找候选技能并建议安装内容，但不会自动安装或注入Skill。

Use Cases

使用场景

Initial bootstrap: The Agent starts with only this skill, then recommends which skills to install for the current task.
On-demand extension: When a task requires a Skill that is not available, suggest the best matches and how to install them.
Capability discovery: Help users find relevant skills from local indexes or public catalogs.

初始引导：Agent仅以该Skill启动，随后针对当前任务推荐需要安装的Skill。
按需扩展：当任务需要的Skill不可用时，推荐最匹配的Skill及安装方法。
能力发现：帮助用户从本地索引或公共目录中找到相关Skill。

Behavior

行为逻辑

Discovery: Prefer local
```
skills/INDEX.md
```
and
```
manifest.json
```
for the capability map. If the user asks for external options and network access is available, search a public catalog (e.g. SkillsMP).
Matching: Match the user task to
```
name
```
,
```
description
```
, and
```
tags
```
; select the best 1–3 skills.
Recommendation: Explain why each skill matches and whether it is local or external.
Installation guidance: Provide the exact install command for each recommended skill (e.g.
```
npx skills add owner/repo --skill name
```
).
Confirmation: If the user asks the Agent to install, request explicit confirmation before running any command.

发现阶段：优先从本地
```
skills/INDEX.md
```
和
```
manifest.json
```
获取能力映射。若用户请求外部选项且网络可用，则搜索公共目录（如SkillsMP）。
匹配阶段：将用户任务与Skill的
```
name
```
、
```
description
```
和
```
tags
```
进行匹配；选择最匹配的1–3个Skill。
推荐阶段：说明每个Skill匹配的原因，以及该Skill是本地还是外部资源。
安装指导：为每个推荐的Skill提供准确的安装命令（例如
```
npx skills add owner/repo --skill name
```
）。
确认机制：若用户要求Agent进行安装，在执行任何命令前需请求用户的明确确认。

Input & Output

输入与输出

Input:
- Description of the current task.
- Optional: list of already installed skills.
- Optional: allowed sources (local only vs public catalogs).
Output:
- Recommended skills with rationale.
- Install commands for each recommendation.

输入:
- 当前任务的描述。
- 可选：已安装Skill的列表。
- 可选：允许的来源（仅本地 vs 公共目录）。
输出:
- 带有匹配理由的推荐Skill。
- 每个推荐Skill的安装命令。

Restrictions

限制条件

No auto-install: Do not execute install commands without explicit user confirmation.
No auto-injection: Do not fetch or inject remote SKILL.md content automatically.
No bulk discovery: Avoid listing large catalogs; return only the top 1–3 matches.

禁止自动安装：未经用户明确确认，不得执行安装命令。
禁止自动注入：不得自动获取或注入远程SKILL.md内容。
禁止批量发现：避免列出大型目录；仅返回前1–3个匹配项。

Self-Check

自我检查

Relevance: Are the recommendations strongly related to the current task?
Actionable: Are install commands concrete and correct?
Consent: Did the Agent avoid running installs without explicit confirmation?

相关性：推荐内容是否与当前任务高度相关？
可操作性：安装命令是否具体且正确？
合规性：Agent是否在未经明确确认的情况下避免执行安装操作？

Examples

示例

Example 1: Recommend a local skill

示例1：推荐本地Skill

Scenario: User asks for a standardized README.

Steps:

Agent checks
```
skills/INDEX.md
```
.
Finds
```
generate-standard-readme
```
.

Recommends it and provides:

npx skills add nesnilnehc/ai-cortex --skill generate-standard-readme

场景：用户需要生成标准化的README。

步骤:

Agent检查
```
skills/INDEX.md
```
。
找到
```
generate-standard-readme
```
Skill。

推荐该Skill并提供命令：

npx skills add nesnilnehc/ai-cortex --skill generate-standard-readme

。

Example 2: Edge case - no local match

示例2：边缘情况 - 无本地匹配项

Scenario: The task is niche and no local skill matches.
Expected: Offer 1–3 external suggestions (if allowed) with install commands, or say "no match found" and ask for clarification. Do not install automatically.

场景：任务非常小众，没有匹配的本地Skill。
预期结果：若允许外部资源，提供1–3个外部建议及安装命令；否则提示“未找到匹配项”并请求用户进一步说明。不得自动安装。

Appendix: Output contract

附录：输出规范

When this skill produces recommendations, it follows this contract:

Element	Requirement
Count	Top 1–3 matches only; no bulk catalog listing.
Per skill	Name, rationale (why it matches), install command (e.g. `npx skills add owner/repo --skill name` ).
Source	Prefer local `skills/INDEX.md` and `manifest.json` ; external only when user asks and network available.
Interaction	Do not run install commands without explicit user confirmation.

当该Skill生成推荐内容时，需遵循以下规范：

元素	要求
数量	仅返回前1–3个匹配项；不得批量列出目录。
单Skill信息	名称、匹配理由、安装命令（例如 `npx skills add owner/repo --skill name` ）。
来源优先级	优先使用本地 `skills/INDEX.md` 和 `manifest.json` ；仅在用户请求且网络可用时使用外部资源。
交互规则	未经用户明确确认，不得执行安装命令。