skill-finder

Skill 搜索与发现

帮助用户发现和安装新的 Skill，浏览已安装的 Skill，以及从社区搜索和下载 Skill。

使用场景

• 用户说「有没有 XX 的 Skill」「帮我找一个能做 XX 的技能」
• 用户说「我有哪些 Skill」「列出所有技能」
• 用户说「安装一个 XX Skill」「从社区找 Skill」
• 用户想扩展 Agent 的能力，问「能不能做 XX」而当前没有对应 Skill
• 用户提到 skills.sh 或 Agent Skills 生态
• 用户要求安装 MCP Server 或 MCP 工具（如 chrome-mcp、filesystem-mcp 等）

---

功能 1：浏览已安装的 Skill

列出所有已安装 Skill

读取 skill_registry.yaml 获取完整列表：

import os
import yaml
from pathlib import Path

instance_name = os.environ.get("AGENT_INSTANCE", "xiaodazi")
registry_path = Path(f"instances/{instance_name}/skills/skill_registry.yaml")
registry = yaml.safe_load(registry_path.read_text(encoding="utf-8"))

skills = registry.get("skills", [])
for s in skills:
    status_icon = {"ready": "✅", "need_auth": "🔐", "need_setup": "⚙️", "unavailable": "❌"}.get(s.get("status", ""), "❓")
    name = s.get("name", "")
    enabled = "启用" if s.get("enabled", True) else "禁用"
    print(f"{status_icon} {name} ({enabled})")

print(f"\n共 {len(skills)} 个 Skill")

查看 Skill 详情

读取指定 Skill 的 SKILL.md 获取详细信息：

import os
from pathlib import Path

instance_name = os.environ.get("AGENT_INSTANCE", "xiaodazi")
skill_name = "要查看的skill名称"

# 按优先级搜索
for base in [
    Path(f"instances/{instance_name}/skills"),
    Path("skills/library"),
]:
    skill_md = base / skill_name / "SKILL.md"
    if skill_md.exists():
        content = skill_md.read_text(encoding="utf-8")
        print(content[:2000])  # 输出前 2000 字符
        break
else:
    print(f"未找到 Skill: {skill_name}")

按分类筛选

读取 config/skills.yaml 中的 skill_groups 按分组展示：

import os
import yaml
from pathlib import Path

instance_name = os.environ.get("AGENT_INSTANCE", "xiaodazi")
config_path = Path(f"instances/{instance_name}/config/skills.yaml")
config = yaml.safe_load(config_path.read_text(encoding="utf-8"))

groups = config.get("skill_groups", {})
for group_name, group_info in groups.items():
    if group_name.startswith("_"):
        continue
    desc = group_info.get("description", "")
    skills = group_info.get("skills", [])
    print(f"\n📂 {group_name} ({len(skills)} 个)")
    print(f"   {desc}")
    for s in skills:
        print(f"   - {s}")