关于 skill-finder
skill-finder 是面向 Agent Skills 的搜索与管理工具,适合寻找特定任务所需技能的用户。它检索索引来源,并支持本地安装、收藏、更新和相似技能查询。
主要功能
- 01搜索本地索引、GitHub 和网页
- 02按类别标签筛选技能
- 03在本地安装技能
- 04收藏并查看已收藏技能
- 05更新来源索引
- 06查找相似技能
适用场景
- 01查找适用于某项任务或领域的技能
- 02将选定技能安装到本地
- 03查看并整理收藏的技能
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ aktsmm/ agent-skills --skill skill-finder安装后在 Claude Code 中输入/skill-finder确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
LICENSE.txtreferences/agent-instructions.mdcustomization-routing.mdsetup-guide.mdskill-index.jsonskill-index.schema.jsonstarred-skills.jsonvscode-extension-design.mdscripts/search_skills.pySearch-Skills.ps1update_other_descriptions.pyupdate_scientific_descriptions.py详细介绍
技能查找器
功能齐全的 Agent Skills 管理工具。
适用场景
- 查找技能、搜索技能、安装技能、技能搜索
- 为特定任务或领域寻找技能
- 在本地查找并安装技能
- 使用星标功能管理收藏
- 在推荐技能前,确认用户的需求是否确实需要技能
推荐前置检查
搜索前,先确认用户的需求是否确实需要 技能,而不是提示词、指令、Agent 或钩子。如果不需要,应先说明,而不是勉强推荐技能。
→ 关于路由模式,请参阅 references/customization-routing.md。
功能
| 功能 | 描述 |
|---|---|
| 搜索 | 本地索引 + GitHub API + Web 回退 |
| 标签 | 按类别筛选(#azure #bicep) |
| 安装 | 下载到本地目录 |
| 星标 | 标记并管理收藏 |
| 更新 | 从 GitHub 同步所有来源 |
快速开始
# Search
python scripts/search_skills.py "pdf"
python scripts/search_skills.py "#azure #development"
# Management
python scripts/search_skills.py --info skill-name
python scripts/search_skills.py --install skill-name
python scripts/search_skills.py --star skill-name
# Index
python scripts/search_skills.py --update
python scripts/search_skills.py --add-source https://github.com/owner/repo
命令参考
| 命令 | 描述 |
|---|---|
<query> | 按关键词搜索技能 |
#tag | 按类别筛选 |
--info SKILL | 显示技能详情 |
--install SKILL | 在本地下载技能 |
--star SKILL | 添加到收藏 |
--list-starred | 显示收藏 |
--similar SKILL | 查找相似技能 |
--update | 从来源更新索引 |
--add-source URL | 添加新的来源仓库 |
--stats | 显示索引统计信息 |
--check | 检查依赖项 |
文件
| 文件 | 描述 |
|---|---|
scripts/search_skills.py | Python 脚本 |
scripts/Search-Skills.ps1 | PowerShell 脚本 |
references/skill-index.json | 技能索引(220+ 项技能) |
references/starred-skills.json | 你的星标技能 |
要求
→ 安装说明请参阅 references/setup-guide.md。
| 工具 | 要求 |
|---|---|
GitHub CLI(gh) | 2.0+ |
| curl | 任意版本 |
| Python 或 PowerShell | 二选一 |
Agent 指令
→ 完整指南请参阅 references/agent-instructions.md。
核心规则
- 使用“要执行吗?是/否?”的提议方式
- 自行运行命令,而不是展示给用户
- 在搜索结果后附上提议区块
搜索响应格式
{N} repos, {M} skills searched (last updated: {date})
| Skill | Description | Source | Trust |
| ----- | ----------- | ------ | ----- |
| ... | ... | ... | ... |
**Next?**
1. Install?
2. Details?
3. Update index? (last: {date})
4. Web search?
信任级别
| 类型 | 徽章 | 描述 |
|---|---|---|
official | 官方 | Anthropic / GitHub 官方 |
awesome-list | 精选列表 | 精选列表 |
community | 社区 | 社区制作(风险自负) |
来源策略:
- 默认通过 HTTPS 从
github.com、raw.githubusercontent.com或gist.github.com安装技能来源。任何其他主机都需要用户明确批准,且批准仅适用于当前会话。 - 安装前,展示来源 URL、主机,以及获取的
SKILL.md所需的工具和网络访问权限,然后等待用户明确批准。
完成标准
- 首先确认需求是否适合使用技能
- 搜索查询返回结果
- 安装前说明工具和网络要求
- 按需将技能安装到本地目录
- 按需成功更新索引
评论
支持 Markdown