skill-finder

用途

Skill Finder 是一款功能较完整的 Agent Skills 管理工具，主要用于搜索、安装和管理本地及来自 GitHub 的 Agent Skills，并帮助判断某个任务是否真的需要技能（skill），还是更适合使用提示词（prompt）、指令（instruction）、智能体（agent）或钩子（hook）等其他定制方式。

主要能力

搜索：通过本地索引、GitHub API 以及网页回退三种方式搜索技能。
标签筛选：可按分类标签过滤，例如 #azure、#bicep。
安装：将技能下载到本地目录。
收藏（Star）：标记并管理常用收藏。
更新：从 GitHub 同步所有来源。
此外还支持查看技能详情、查找相似技能、添加新的来源仓库、查看索引统计以及校验依赖。

使用方式

快速开始（命令）：

# 搜索
python scripts/search_skills.py "pdf"
python scripts/search_skills.py "#azure #development"

# 管理
python scripts/search_skills.py --info skill-name
python scripts/search_skills.py --install skill-name
python scripts/search_skills.py --star skill-name

# 索引
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	收藏的技能

适用场景

需要为特定任务或领域查找技能。
想在本地查找并安装技能。
想用星标功能管理自己收藏的技能。
在推荐技能之前，需要先判断某个请求是否真的适合用技能解决。

信任级别

类型	徽章	说明
official	Official	Anthropic / GitHub 官方
awesome-list	Curated	精选列表
community	Community	社区制作（自行承担风险）

来源策略

默认仅允许通过 HTTPS 从 github.com、raw.githubusercontent.com 或 gist.github.com 安装技能来源。其他主机需要用户按当前会话范围明确批准。
安装前，先展示来源 URL、主机名，以及所获取的 SKILL.md 所需的工具和网络访问权限，然后等待用户明确批准。

要求

安装说明参见 references/setup-guide.md。

工具	要求
GitHub CLI (gh)	2.0+
curl	任意
Python 或 PowerShell	二者之一

智能体指令

完整指南参见 references/agent-instructions.md。

核心规则

使用「Do it? Yes/No?」风格的提议。
自行运行命令，而不是把命令展示给用户。
在搜索结果之后附上提议区块。

搜索响应格式

{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?

完成标准

首先检查是技能还是非技能更合适。
搜索查询返回结果。
安装前展示工具和网络要求。
技能已安装到本地目录（如被要求）。
索引更新成功（如被要求）。

限制

当前资料未提供关于收费、价格、平台兼容范围及性能效果的具体说明。

技能介绍

用途