关于 banana-skill-finder
banana-skill-finder 是面向 Claude 技能的发现与安装指南,会根据任务主动搜索并推荐相关技能。它采用多层搜索来源,并在用户批准后引导安装。
主要功能
- 01主动识别适合专用技能的任务
- 02使用 SkillsMP、skills.sh 和 GitHub 搜索
- 03按相关性筛选并推荐 1–3 项
- 04获批准后通过 skills CLI 安装
适用场景
- 01处理特定文件格式或技术任务
- 02寻找重复工作或专业领域技能
- 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.jsonreferences/api_config.mdskill_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-3 个,不要列出长长的清单
-
智能三级搜索:
- 第 1 级:SkillsMP AI 搜索(最佳,前提是已配置)
- 第 2 级:skills.sh 排行榜(良好,始终可用)
- 第 3 级:GitHub API(备用方案,受请求频率限制)
- 找到合适的匹配项后停止
-
说明相关性:始终解释每项技能为何符合用户需求
-
轻松安装:使用
npx skills add owner/repo,通过一条命令完成安装 -
建议配置 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 或数据分析技能
其他资源
详细信息请参阅:
- references/api_config.md - 如何设置 SkillsMP API 密钥
- references/skill_sources.md - 技能来源、类别和搜索策略
设置建议
为获得最佳效果,建议用户配置 SkillsMP API 密钥:
- 访问 https://skillsmp.com/docs/api
- 生成 API 密钥
- 设置环境变量:
export SKILLSMP_API_KEY="sk_live_..."
这样可以启用 AI 语义搜索(效果远胜关键词匹配)。如果未配置,技能会自动回退到 skills.sh 排行榜搜索,大多数情况下仍能很好地工作。