skillsui icon

skillsui

skillsui 是一款面向 skills.sh skills 管理的键盘驱动终端 UI,支持项目与全局范围的技能管理,内置安装、更新、移动、删除和搜索流程,直接读写磁盘上的技能文件夹与锁定文件。

skillsui

概述

skillsui 是一款用于管理 skills.sh skills 的终端 UI。它将项目和全局 skill 范围以双窗格方式呈现,并完全通过键盘驱动。

该工具不使用数据库或配置文件。相反,它从磁盘读取 skill 文件夹和 CLI 锁定文件,并在你移动、删除、更新、fork 或安装 skills 时,把更改写回这些相同的文件。

主要能力

双窗格终端布局

在左侧显示项目 skills、右侧显示全局 skills,并支持通过键盘在两个窗格之间导航。

磁盘支持的状态

直接从磁盘读取 skill 文件夹和 CLI 锁定文件,然后将操作持久化回同一批文件。

Skill 管理操作

支持移动、删除、更新和 fork skills,并可在两个窗格中批量选择后执行删除和更新。

内置搜索和安装流程

搜索 skills.sh,并在安装到项目或全局范围之前预览某个 skill。

Claude Code 友好的安装路径

为 Claude Code 将已安装的 skills 链接到 .claude/skills,同时把规范副本保留在 .agents/skills。

安装器和更新器

提供发布版安装和自更新命令,包括对下载内容进行校验和验证。

感知锁定文件的状态

根据锁定文件是否存在以及磁盘上是否缺少文件夹,识别已跟踪、本地和隐藏的 skills。

常见用例

  • 仓库级 skill 管理

    在仓库根目录内管理项目范围的 skills,项目窗格会显示 .agents/skills 及其对应的锁定文件。

  • 全局 skill 管理

    查看并整理 ~/.agents/skills 中的全局 skills 库,包括在配置了 XDG 状态位置时存储在该位置下的条目。

  • 搜索驱动的安装

    搜索 skills.sh,查看预览,并通过分屏模态窗口将选定的 skill 安装到项目或全局范围。

  • 批量维护

    使用批量选择一次更新或删除多个已跟踪的 skills,并对破坏性操作进行确认和绝对路径安全检查。

  • 范围变更与本地变体

    在你希望更改 skill 范围或在新名称下创建本地变体时,移动或 fork 一个 skill。

Pros and Cons

Pros

  • 以键盘优先的工作流为主,支持 h/j/k/l 导航和操作快捷键。
  • 不需要数据库或配置文件;状态保存在现有的 skill 文件夹和锁定文件中。
  • 同时支持项目和全局 skill 范围。
  • 可以在安装前预览 skill。
  • 安装器使用 SHA-256 验证下载内容,并支持自更新。
  • 将规范 skills 保留在 .agents/skills 中,并链接到 .claude/skills 供 Claude Code 使用。

Cons

  • 该工具以基于文件系统的 skill 文件夹和锁定文件为中心,因此它并不是面向无关内容类型的通用 UI。
  • 在 home 目录运行时,项目和全局窗格会指向同一位置,因此应用会改为只显示全局窗格。

FAQ

skillsui 管理什么?

它是一款用于管理 skills.sh skills 的终端 UI。它从磁盘读取 skill 文件夹和 CLI 锁定文件,并把更改写回这些相同的文件,因此状态保留在本地文件系统中,而不是数据库或配置文件里。

支持哪些平台?

README 说明发布二进制文件覆盖 macOS 和 glibc Linux,支持 ARM64 和 x64。

skillsui 是开源的吗?

是的。该项目在 GitHub 上开源,仓库主页显示为公开仓库,并在文件列表中标注了 MIT 许可证。

如何安装和更新?

README 描述了通过运行提供的 shell 安装程序进行安装,该程序会验证 SHA-256 校验和并将二进制文件写入 ~/.local/bin。它也支持使用 skillsui update 进行更新。

它能同时处理项目和全局 skill 位置吗?

它是为项目和全局 skill 范围设计的。从项目根目录运行时会显示两个窗格;从 home 目录运行时只会显示全局窗格,因为此时两个范围本来就会指向同一个文件夹。

Quick Facts

类别
开发者工具
来源域名
github.com
仓库可见性
公开
许可证
MIT
主要工作流
基于终端的 skills.sh skills 管理
支持的发布平台
macOS 和 glibc Linux,支持 ARM64 和 x64