tools-only Awesome-Skills-Hub (ASH) 🚀
一处管理，全平台同步 — 技能装一次，Cursor、Claude、Windsurf 等主流 AI IDE 即刻可用。
English | 简体中文 | 贡献指南
📑 目录
🌟 核心亮点
- 双重作用域 (Dual-Scope)：支持 全局作用域（用户目录
~/.ash/skills）和 项目作用域（项目内的 IDE 技能配置目录）双维度管理。 - 通用 IDE 桥接: 标准化的
.claude/skills架构，自动生成兼容 Cursor, Windsurf, TRAE, Antigravity 和 Copilot 的桥接配置。 - Homebrew 式管理：将技能统一托管在系统家目录 (
~/.ash)，做 IDE 之外的"军火库"。 - 实时软链：本地更新技能文件，所有关联的 IDE 瞬间生效。
- 生态集成：支持自动导入
npx skills下载的技能 (详见生态集成节)。 - 智能 Monorepo 发现: 交互式扫描并安装复杂仓库中的技能（支持多选/全选，如
huggingface/skills）。 - 元技能 (Meta-Skill): 赋能您的 Agent 自主搜索并安装所需技能 (
ash search->ash add)。
💡 为什么选择 ASH? ("桥梁"哲学)
与那些仅提供skills下载（仓库型）或试图统一所有 Agent 格式（加载器型）的工具不同，ASH 的定位是一座物理 桥梁 (Bridge)。
| 特性 | 🛠️ 其他工具 (如 OpenSkills) | 🚀 ASH (本项目) |
|---|---|---|
| 设计哲学 | 加载器 (Loader): 为特定 Agent 生成配置文件。 | 桥梁 (Bridge): 直接将技能投递到 IDE 的"家门口" (~/.cursor/skills 等)。 |
| 兼容性 | 需要 Agent 支持特定标准/插件。 | 通用性: 只要 IDE 读取配置文件，ASH 就即刻可用，无需等待插件适配。 |
| 分发效率 | "一个技能装一次" | "一次安装，处处可用": 只要装一次，瞬间同步给 8+ 个主流 IDE。 |
| 发现机制 | 手动指定路径 | 智能 Monorepo 扫描: 自动探测子目录中的技能。 |
📦 安装指南
1. 免安装试用 (Zero-Install)
无需安装，直接通过 npx 运行：
💡 小贴士: 您可以使用短别名
npx askill代替冗长的npx awesome-skills-hub。
# 1. 浏览技能库
npx askill list
# 2. 安装技能 (自动初始化并同步到 IDE)
npx askill install pdf
💡 小贴士: 免安装模式仅限可以使用内置技能。如需管理完整技能库（包括添加自定义技能）并获得秒级响应，请务必使用 快速安装。
2. 快速安装 (推荐)
通过 NPM (跨平台首选):
# 1. 全局安装 (获取 'ash' 命令，将其加入系统 PATH)
npm install -g askill
# 2. 初始化环境 (自动检测您的 IDE 并创建 ~/.ash 技能库)
ash init
# 3. 验证安装 (查看所有可用技能)
ash list
3. 备选安装 (Shell 脚本)
如果您没有安装 Node.js：
macOS / Linux:
curl -fsSL https://raw.githubusercontent.com/tiandee/awesome-skills-hub/main/install.sh | bash
Windows (已支持):
# PowerShell 一键安装（若未安装 Git 请先安装）
irm https://raw.githubusercontent.com/tiandee/awesome-skills-hub/main/install.ps1 | iex
# 重载配置后即可使用 ash 命令
. $PROFILE
4. 手动安装 (Clone)
如果您希望参与贡献代码：
macOS / Linux:
# 执行安装脚本
bash install.sh
# 重启终端或运行源配置
source ~/.zshrc # 或 ~/.bashrc
Windows:
# 克隆后在项目目录执行
.\install.ps1
# 重载配置
. $PROFILE
安装脚本将自动执行：
- 检测并初始化本地所有主流 AI IDE 环境。
- 初始化全局目录：在您的家目录创建
~/.ash/skills(Windows 为~\.ash\skills) 作为持久化存储。 - 自动配置环境变量，支持 Zsh, Bash 和 Fish。
- 实现全局命令
ash的一键访问。
📖 使用手册
1. 浏览技能库
查看来自 Anthropic 官方的实用技能：
ash list
2. 查看技能详情
了解某个技能的详细用途、触发词或内容预览：
ash info pdf # 支持模糊匹配名称
3. 安装技能 (全局 / 用户级)
将技能链接到您的 用户家目录 (~/.ash/skills)，即刻在所有支持的 IDE 全局配置中生效。
ash add pdf # 智能通过名称安装 (全局)。(install 的现代别名)
ash add --all # 一键同步所有 17+ 技能到所有 IDE
4. 项目模式 (本地安装 / 项目级) 🆕
将技能直接安装到 当前项目目录，方便团队共享或隔离使用。
ASH 强制使用 .claude/skills 作为核心标准，并自动桥接到您当前的 IDE 配置目录。
cd my-project
ash add java -p # 安装到当前项目的 ./.claude/skills
ash add --all -p # 将所有技能批量注入当前项目
支持自动桥接的 IDE:
5. 命令参考 (CLI Reference) 🆕
| 命令 | 用途描述 | 基本用法示例 |
|---|---|---|
init |
初始化 ASH 环境。在本地创建 ~/.ash 目录并准备内置技能库。 |
ash init |
list |
列出可用技能。显示所有内置、下载及系统技能的名称、分类和物理路径。 | ash list (别名: ls) |
add |
安装并分发技能。将指定技能软链接到所有支持的 AI IDE 中。同时也支持从 GitHub 直接下载并安装。 | ash add <技能名>ash add <GitHub_URL>ash add --all (全装) |
info |
查看技能详情。显示技能的元数据、描述以及核心 Prompt 的预览。 | ash info <技能名> |
search |
搜索技能。在技能名称和描述中通过关键词检索。 | ash search <关键词> |
status |
查看部署状态。显示各 IDE 已安装的技能总数。支持查看特定 IDE 的详细映射。 | ash statusash status --fullash status cursor |
uninstall |
移除技能链接。从各 IDE 的技能目录中通过软链接移除指定技能（不删源文件）。 | ash uninstall <技能名>ash uninstall --all |
clean |
清空 IDE 目录。一键清空某个 IDE 或所有 IDE 下的所有技能链接。 | ash clean <ide_name>ash clean --all |
sync |
生态同步。扫描 Vercel/Agents 等外部生态的技能目录并导入到 ASH 体系中。 | ash sync |
🚀 生态集成 (Ecosystem Integration)
ASH 能够自动感知并导入 Vercel 生态的技能。
Vercel 官方推出了 npx skills 工具，它将技能下载到 ~/.agents/skills。ASH 可以自动扫描该目录，将上面的优质技能一键桥接到所有 IDE 中。
- 下载: 使用 Vercel 工具下载你喜欢的技能：
npx skills add user/repo - 同步: 让 ASH 接管并分发：
(此时 ASH 会提示发现新技能，确认后即可在 Cursor/Windsurf 等工具中直接使用)ash sync
💡 资源推荐
想要寻找优质的中文 Skill？推荐访问 Skill Hub 中国。 该网站收录了大量高质量的 agent 技能，例如 Anthropic 官方的前端设计技能：
# 示例：安装 Anthropic 的 frontend-design 技能
npx skills add https://github.com/anthropics/skills --skill frontend-design
# 让 ASH 自动分发
ash sync
6. 状态与搜索
ash search web # 关键词搜索
ash status # 查看当前安装映射状态
7. 清理与重置
一键清空指定 IDE 或所有 IDE 的技能链接。
ash clean cursor # 仅清空 Cursor 的技能
ash clean --all # 清空所有 IDE 的技能 (核弹选项)
8. 卸载技能
移除技能链接。
ash uninstall pdf # 卸载指定技能
ash uninstall --all # (同 clean --all)
9. 同步技能库
从源码仓库或远程同步最新的技能到全局目录。
ash sync
10. CLI 工具维护
管理 ash 工具本身：
# 升级到最新版本
npm update -g askill
# 查看当前已安装版本
npm list -g askill
# 查询远程最新版本号
npm view askill version
# 卸载 CLI 工具
npm uninstall -g askill
📂 系统架构
- 软件家目录 (
ASH_HOME):~/.ash(或$env:USERPROFILE\.ash) - 技能存储仓:
~/.ash/skills/ - IDE 链接目标: 所有 IDE 中的软链接均精准指向上述全局目录。
🧩 交互亮点
- 智能纠错：输错命令时（如
ash intall），工具会智能提示："您是不是想输入ash install？" - 透明反馈：批量操作时提供清晰的 IDE 级汇总报告，确保操作可审计。
🤝 支持平台
| 平台 | 目标路径 | 状态 |
|---|---|---|
~/.agent/skills/ |
✅ | |
~/.cursor/skills/ |
✅ | |
~/.trae/skills/ |
✅ | |
~/.windsurf/skills/ |
✅ | |
~/.copilot/skills/ |
✅ | |
~/.claude/skills/ |
✅ |
🛠️ 贡献代码
欢迎贡献您的实用提示词或规则！
- Fork 本仓库。
- 在
skills/<name>/中创建您技能目录。 - 添加
SKILL.md(内容) 和可选的scripts/。 - 提交 Pull Request。
📄 开源协议
MIT © Tiandee