mcpField
B
banana-skill-finder

banana-skill-finder

github.com/treydongAgent 工作流1666 次安装31 周前更新
代码仓库

关于 banana-skill-finder

banana-skill-finder 是面向 Claude 技能的发现与安装指南,会根据任务主动搜索并推荐相关技能。它采用多层搜索来源,并在用户批准后引导安装。

主要功能

  1. 01主动识别适合专用技能的任务
  2. 02使用 SkillsMP、skills.sh 和 GitHub 搜索
  3. 03按相关性筛选并推荐 1–3 项
  4. 04获批准后通过 skills CLI 安装

适用场景

  1. 01处理特定文件格式或技术任务
  2. 02寻找重复工作或专业领域技能
  3. 03为 PDF、React 或 AWS 任务查找技能

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/treydong/banana-skills --skill banana-skill-finder

安装后在 Claude Code 中输入/banana-skill-finder确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

metadata.json
references/
api_config.md
skill_sources.md

详细介绍

Banana Skill Finder

主动帮助用户发现并安装相关的 Claude 技能,适用于用户遇到可以借助专门能力完成的任务时。

何时使用此技能

检测到以下情况时自动触发(无需用户请求):

  • 使用特定文件格式或技术
  • 描述重复性或专业性任务
  • 询问“有没有适用于……的技能/工具?”或类似问题
  • 在特定领域的工作中遇到困难
  • 任何可能受益于专门技能的任务

重要:应主动触发此技能。不要等待用户明确要求推荐技能。

工作流

1. 分析用户需求

识别:

  • 核心任务:用户想完成什么?
  • 领域:属于哪一类?(开发、文档、数据、Web、DevOps、内容等)
  • 关键词:提取 2-4 个相关搜索词
2. 搜索技能

采用三级策略,并在失败时自动回退:

第 1 级:SkillsMP API(最佳,前提是已配置)

# Check for API key
echo $SKILLSMP_API_KEY

# If exists, use AI semantic search
curl -X GET "https://skillsmp.com/api/v1/skills/ai-search?q={natural_language_query}" \
  -H "Authorization: Bearer $SKILLSMP_API_KEY"

优点:

  • AI 能理解用户意图,而不只是关键词
  • 可访问 60,000+ 个精选技能
  • 相关性和质量指标最佳

第 2 级:skills.sh WebFetch(良好,始终可用)

# Try search with query parameter
Use WebFetch: https://skills.sh/?q={keywords}

# Or browse leaderboard
Use WebFetch: https://skills.sh  # All-time popular
Use WebFetch: https://skills.sh/trending  # Trending (24h)

优点:

  • 200+ 个高质量精选技能
  • 无需身份验证
  • 按安装次数排名
  • 显示热门趋势技能

第 3 级:GitHub API(备用方案,可能受限)

curl -X GET "https://api.github.com/search/code?q={keywords}+SKILL.md+language:markdown" \
  -H "Accept: application/vnd.github.v3+json"

注意:未进行身份验证时,每小时限制 60 次请求,仅在最后不得已时使用。

可选:检查本地已安装的技能

ls ~/.claude/skills/

检查用户是否已安装相关技能但尚未使用。

推荐顺序:依次尝试第 1 级 → 第 2 级 → 第 3 级。找到合适的匹配项后停止。

3. 按相关性排序

根据以下因素为找到的每个技能评分:

  • 与用户需求的关键词匹配度(最重要)
  • 功能契合度
  • 质量指标(星标数、近期活动)
  • 专业程度与通用程度

选出最相关的 1-3 个技能。重质不重量。

4. 提供推荐

按以下格式提供推荐:

I found [N] skill(s) that could help:

**1. [Skill Name]** - [One-line description]
   Source: [SkillsMP/GitHub/Vercel]
   Repository: [owner/repo]
   Why relevant: [Brief explanation]
   Install: `npx skills add [owner]/[repo]`

[Repeat for 2-3 skills max]

Would you like me to install any of these?
5. 获得批准后安装

用户批准后,使用 Vercel 的 skills CLI 安装:

npx skills add <owner>/<repo>

示例:

npx skills add vercel-labs/agent-skills
npx skills add anthropics/skills

此命令将:

  • 从 GitHub 下载技能
  • 安装到 ~/.claude/skills/
  • 支持 Claude Code、Cursor、Windsurf 和其他 Agent
  • 通过匿名遥测记录安装情况(排行榜)

确认安装成功,并说明该技能将如何提供帮助。

核心原则

  1. 主动,而非被动:在相关情况下自动触发,不要等用户提出要求

  2. 重质不重量:只推荐最合适的 1-3 个,不要列出长长的清单

  3. 智能三级搜索:

    • 第 1 级:SkillsMP AI 搜索(最佳,前提是已配置)
    • 第 2 级:skills.sh 排行榜(良好,始终可用)
    • 第 3 级:GitHub API(备用方案,受请求频率限制)
    • 找到合适的匹配项后停止
  4. 说明相关性:始终解释每项技能为何符合用户需求

  5. 轻松安装:使用 npx skills add owner/repo,通过一条命令完成安装

  6. 建议配置 API 密钥,但并非必需:配置 SkillsMP API 密钥可获得最佳结果,但 skills.sh 回退方案也很有效

示例

用户说:“我需要从 PDF 文件中提取文本” → 触发技能查找器,搜索 PDF 处理技能,推荐 pdf-editor 或类似技能

用户说:“帮我检查这个 React 组件” → 触发技能查找器,搜索 React/代码审查技能,推荐 Vercel 提供的 react-best-practices

用户说:“我要部署到 AWS” → 触发技能查找器,搜索 AWS/部署技能,推荐 cloud-deploy 或 aws-helper

用户说:“如何查询这个 BigQuery 表?” → 触发技能查找器,搜索 BigQuery/SQL 技能,推荐 bigquery 或数据分析技能

其他资源

详细信息请参阅:

设置建议

为获得最佳效果,建议用户配置 SkillsMP API 密钥:

  1. 访问 https://skillsmp.com/docs/api
  2. 生成 API 密钥
  3. 设置环境变量:export SKILLSMP_API_KEY="sk_live_..."

这样可以启用 AI 语义搜索(效果远胜关键词匹配)。如果未配置,技能会自动回退到 skills.sh 排行榜搜索,大多数情况下仍能很好地工作。

评论

支持 Markdown