स्किल्स पर वापस
awesome-skills-hub
tiandee द्वारा
Cursor—अभी तक कोई रेटिंग नहीं
आपकी रेटिंग
संक्षिप्त
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 — में पेस्ट करें, और वह स्किल को सीधे सोर्स रिपॉज़िटरी से इंस्टॉल कर देगा।
रिपॉज़िटरी खोलें