본문으로 건너뛰기
TakoAPI
스킬로 돌아가기

awesome-skills-hub

tiandee 제작

Windsurf
—아직 평가 없음
내 평가

요약

A professional package manager for AI IDE skills & rules. Centralize your prompts and sync across Antigravity, Cursor, Windsurf, and Claude with "Write Once, Link Everywhere" simplicity.

설명

# Awesome Skills Hub(ASH)

ASH 是 `~/.agents/skills` 的本地控制台:用同一套安全规则管理你自己拥有的
Agent Skill,查看来源、检查更新、建立基线、打包、快照迁移和可恢复移除。

> 默认文档为中文。可阅读 [English](README_EN.md)、[详细中文参考](README_CN.md)
> 和[控制面设计](doc/SKILL_CONTROL_PLANE.md)。

## 先了解 v2 的边界

ASH v2 只管理一个可写根目录:`~/.agents/skills`。

- 管理用户自行创建、通过安装器安装或明确链接进来的用户 Skill;
- 只读扫描目录可以展示和链接,但不会被直接修改;
- Codex Store、系统 Skill、插件 Skill,以及 Cursor、Claude、Windsurf、TRAE、
  Copilot 等客户端私有目录,都由各自的所有者维护;
- 每一次写操作都遵循:**预览 → 明确确认 → 状态重检 → 事务记录/可回滚**。

如果你从 ASH v1 升级:以前的“按 Agent 分发、同步状态、清理/卸载”模型已移除。
v2 不会创建或迁移客户端专属 Skill 目录。

## 安装与启动

从 npm 安装:

```bash
npm install -g askill
ash init
ash ui
```

从源码运行:

```bash
git clone https://github.com/tiandee/awesome-skills-hub.git
cd awesome-skills-hub
npm install -g .
ash init
ash ui
```

`ash init` 只会在用户库不存在时创建空目录,不会自动下载、覆盖或复制任何 Skill。
`ash ui` 只绑定 `127.0.0.1`;也可指定端口但不自动打开浏览器:

```bash
ash ui --port 4173 --no-open
# 端口已被正在运行的 ASH 页面占用时,安全重启它
ash ui --port 4173 --no-open --restart
```

`--restart` 只会终止通过 `127.0.0.1:<port>/api/health` 确认的 ASH 页面;未知进程
占用端口时会拒绝操作,不会误杀其他服务。被 launchd 托管的页面会由 launchd 拉起;
手动启动的页面则由当前命令接管。

## 三条最常用路径

### 1. 在网页中管理本地 Skill

打开 `ash ui` 后,先从“Skill 库”查看用户库、只读扫描来源和每个 Skill 的更新状态。

- 用来源筛选 + 状态筛选找到同类 Skill;状态计数会随当前来源范围变化;
- “推荐安装”首批提供 3 个场景包、10 个候选;会标记“已安装”与“同名已存在”,不会自动安装或内置第三方 Skill 内容;
- 勾选多个 Skill 后,可生成一个 `.ashpack` 分享包;接收方通过“导入分享包”预览校验、同名冲突后再确认安装。单个 Skill 仍可生成确定性的 `.skill` 包;
- “管理上游”会先校验 GitHub 来源、目录与文件差异,确认后才建立/重建基线或更新;
- “维护”页提供更新回滚、回收站恢复、快照和事务保留期清理。

### 2. 为体积较大的第三方 Skill 使用终端安装

网页的“发现安装”会先校验 GitHub 路径和可执行文件。对于根目录很大、文件很多、
或需要 `skills` CLI 原生安装体验的仓库,可以改用终端:

```bash
npx skills add owner/repository
ash baseline <skill-name> --apply
ash doctor
```

`baseline` 会为已安装且来源完整的 Skill 写入可比较的 Git tree 基线;重复执行是安全的
no-op。`ash doctor` 会打印警告但默认不把警告视为失败;自动化需要严格阻断时使用:

```bash
ash doctor --strict
```

### 3. 创建、打包与迁移自己的 Skill

```bash
# 创建标准结构
ash create review-release --description "审查发布就绪度和必要证据。"

# 查看与搜索
ash list
ash search release
ash info review-release

# 生成确定性 .skill 包
ash package review-release

# 把用户库迁移到另一台电脑:先预览,再写入
ash snapshot create user-skills.ash-snapshot
ash snapshot restore user-skills.ash-snapshot
ash snapshot restore user-skills.ash-snapshot --apply
ash snapshot verify user-skills.ash-snapshot
```

快照仅覆盖用户库顶层 Skill;不会包含 `.env`、`.local`、`.git`、`node_modules`、
Python 缓存或内部软链接。

## 如何理解“状态”与“健康”

状态描述更新与来源关系,健康描述文件结构与元数据问题;两者不混在一起。

| 页面状态 | 含义 | 推荐动作 |
| --- | --- | --- |
| 等待检查 | 来源可比较,尚未联网检查 | 单项、批量或全库检查 |
| 检查过期 | 上次单项检查已超过 7 天 | 重新检查后再更新 |
| 已是最新 | 已检查且与上游 Git tree 一致 | 按需重新检查 |
| 发现更新 | 上游有变化 | 预览文件差异后更新 |
| 基线缺失 | 来源已知,但缺少可比较基线 | 管理上游并重建基线 |
| 等待接管 | 本地 Skill 还没有更新来源 | 管理上游或声明外部托管 |
| 外部托管 | 用户声明由其他 CLI/工具管理 | 在外部工具中更新 |
| 用户链接 / 只读来源 | 链接或扫描来源,不由 ASH 直接写入 | 按需链接、解除或停止扫描 |

全库检查时间和每个 Skill 的检查时间分别记录在本地状态中;单项重新检查不会伪装成
整个库刚检查过。旧版缓存没有单项时间戳,首次升级后会保守地要求重新检查一次。

## 安全与可恢复性

- 服务仅允许回环地址绑定,写 API 需要页面会话令牌;
- 更新、接管、描述修改、链接、移除和快照恢复都会重新核对预览是否过期;
- 移除默认进入 ASH 回收站事务,恢复前会核对原路径和安装器锁;
- 永久删除只针对回收站副本,需要二次预览和输入确认;
- 更新预览会显示保留的 `.env`、`.local`、内部软链接,以及会丢弃的依赖缓存;
- 额外扫描目录始终只读;“停止扫描”仅删除配置,不会删除目录内容。

本地状态默认位于 `~/.agents/.ash/`,包括更新检查缓存、事务、快照和打包输出;
用户 Skill 内容仍只在 `~/.agents/skills` 中。

## 命令速查

| 命令 | 用途 |
| --- | --- |
| `ash init` | 在缺失时创建空的用户库 |
| `ash ui` | 启动仅本机可访问的管理页面 |
| `ash list` / `ash info` / `ash search` | 浏览和搜索用户库 |
| `ash create` | 创建标准用户 Skill 脚手架 |
| `ash baseline <name> --apply` | 为终端安装的 Skill 重建 Git tree 基线 |
| `ash inventory` | 查看用户库与安装器锁记录 |
| `ash doctor [--strict]` | 审计本地元数据、链接、锁和生成物 |
| `ash repair` / `ash rollback` | 预览并维护 ASH 管理的 Codex 创建引导 |
| `ash package` | 输出确定性的 `.skill` 包 |
| `ash snapshot` | 创建、预览恢复和校验用户库快照 |
| `ash sync` | 当 ASH 以 Git 源码方式安装时执行 `git pull --ff-only` |

`ash sync` 不会同步用户 Skill 到远端;跨电脑迁移使用 snapshot。

## 开发与发布

```bash
npm ci
npx playwright install chromium

# 单元/集成测试、隔离浏览器测试、完整发布门禁
npm test
npm run test:browser
npm run test:release

# 验证真正发布生命周期,不写入 npm
npm publish --dry-run --access public
```

`prepublishOnly` 已绑定 `test:release`:正式 `npm publish` 会先执行所有测试、隔离
浏览器冒烟和 `npm pack --dry-run`。提交前请同时运行 `git diff --check`。

## 深入阅读

- [详细中文参考](README_CN.md):功能清单、配置与完整操作边界;
- [控制面设计](doc/SKILL_CONTROL_PLANE.md):状态模型、事务、更新来源和安全约束;
- [贡献指南](CONTRIBUTING.md):页面优先、CLI 冻结边界与验证要求;
- [更新记录](CHANGELOG.md):版本变化与未发布内容。

## 许可证

[MIT](LICENSE)

설치

https://github.com/tiandee/awesome-skills-hub에서 스킬을 설치해줘

이 스킬은 ClawHub 레지스트리에 게시되지 않았습니다. 프롬프트를 코딩 에이전트(Claude Code, Cursor, Codex)에 붙여넣으면 소스 저장소에서 바로 스킬을 설치합니다.

저장소 열기

링크