lazyskills README

项目的 README,来自 github.com/alvinunreal/lazyskills。合并为一个 markdown 文件:README.md。

Lazy Skills

Lazy Skills

Blazing-fast mission control for agent skills.

CI Go Report Card Release Go License Stars

Lazy Skills - mission control for agent skills. Stay lazy.

"I don't debug broken skills by hand - I have a TUI to be disappointed for me."

🌴 Overview

LazySkills is a blazing-fast terminal UI for managing agent skills. It gives you one place to see what is installed, which agents can use each skill, why visibility may be broken, and what actions are safe to run next.

Lazy Skills terminal UI demo

✨ Features

🛠️ Install

Recommended for macOS and Linux:

curl -fsSL https://lazyskills.sh/install | sh

Or use Homebrew:

brew install --cask alvinunreal/tap/lazyskills

Windows:

irm https://lazyskills.sh/install.ps1 | iex

Go users:

go install github.com/alvinunreal/lazyskills/cmd/lazyskills@latest

Then launch it:

lazyskills

🚀 Getting started

Run LazySkills from a project:

lazyskills

Start with the left pane. It groups skills by source, so you can quickly see what came from the same repo, local folder, or custom install.

Useful keys:

Key What it does
/ Search skills
a Cycle through agent visibility filters
f Toggle project/global/all scopes
enter Open details for a skill or source
c Show available actions
n Find new skills from skills.sh
space Select a skill for bulk actions
u Reinstall/update selected skill
x Remove selected skill
? Show the full keymap

LazySkills previews actions before running them, and destructive actions require confirmation.

For agent-friendly registry search without opening the TUI:

lazyskills find --json "browser automation"

Doctor

Run a read-only health report for the current project:

lazyskills doctor

It ranks scan errors before warnings and shows the affected skill or workspace, path, and safe next step. Use structured output in scripts or other agents:

lazyskills doctor --json
lazyskills doctor --cwd /path/to/project

Doctor never changes skills or lock files. It reports findings and points to commands such as lazyskills restore when a locked skill is missing from disk.

Restore from lock files

Restore skills that are recorded in the project or global lock file but missing from disk:

lazyskills restore --global
lazyskills restore --project
lazyskills restore --all

Pass skill names to restore only those entries, or --yes to accept the preview non-interactively:

lazyskills restore --project code-review tdd
lazyskills restore --global --yes

Without a scope flag, restore checks both scopes. Before each install it rescans and revalidates that skill’s lock identity and restore command, then aborts without running remaining commands if the skill disappeared, its lock metadata changed, or its command changed—reporting any skills already restored. That narrows races with concurrent installs; it does not make restore fully race-free.

🔄 Updates

LazySkills can check for new releases and show the command to update your installation manually.

CLI Update

Run the update command directly from your terminal to check for updates and get upgrade instructions:

lazyskills update

Options:

TUI Update

When a newer version of LazySkills is available, an update notification will appear in the TUI footer: · U update (vX.Y.Z available)

Press U (capital U) from the inventory view to open the update info modal, which will display the release details and the specific terminal command you need to run to upgrade manually.

⭐ Star for a chance to win stickers

Lazy Skills stickers

There are Lazy Skills stickers. Star the repo and you're entered into a draw to win some, shipped worldwide at no cost to you.

Winners are drawn from stargazers and announced in the sticker giveaway issue, tagged by their GitHub username, so you'll get a notification if it's you. Shipping details are arranged privately from there.

📄 License

MIT - see LICENSE.

lazyskills (alvinunreal/lazyskills)

正在搜索数据库…

这是什么?LazySkills 是一个终端界面工具,相当于智能体技能的“总控台”,把所有已安装的技能集中显示在一处,并标明哪些编程智能体实际能够使用它们。
这是图形界面应用还是终端工具?它是一个在终端中运行的 TUI(终端用户界面)应用,不是图形化桌面应用,也不是代码库。
怎样安装和运行?在 macOS/Linux 上运行推荐的安装脚本,或使用 Homebrew、Windows 的一种安装方式,或使用 `go install` 进行安装;然后在项目目录内启动 LazySkills。
它支持哪些编程智能体?它可以检查 Claude Code、OpenCode、Codex、Cursor、Gemini CLI 以及更多智能体的技能可见性。
restore 命令能否完全避免并发安装时的竞争条件?不能。restore 在每次安装前都会重新扫描并重新验证,如果发现有变化就会中止,但作者指出,这只是减少了竞争的可能,并不能让 restore 完全避免竞争条件。
这个工具是为谁做的?为那些在多个项目中使用 AI 编程智能体、并安装了多个技能的开发者设计的,帮助他们无需手动编辑文件即可管理、调试和发现这些技能。
它也能在 Windows 上运行吗,还是只支持 macOS 和 Linux?它支持 macOS、Linux 和 Windows,每个系统都有单独的安装说明。
doctor 命令会修改我的技能或锁文件吗?不会。doctor 健康检查是只读的,只报告检查结果,从不更改技能或锁文件。
Doctor 命令到底做什么?它会对当前项目运行一份只读的健康报告,将扫描错误排在警告之前,并显示受影响的技能、其路径以及一个安全的修复下一步。
不离开 TUI 能查找新技能吗?可以。LazySkills 能在应用内搜索 skills.sh,预览安装命令,并在确认后将技能安装到项目范围或全局范围。
它能检测哪些类型的损坏安装?它会标出缺失的 SKILL.md 文件、无效的 frontmatter、失效的符号链接、缺失的锁文件条目以及幽灵智能体技能。
如果技能从磁盘上丢失,还能恢复吗?可以。`lazyskills restore` 会恢复记录在项目或全局锁文件中、但已从磁盘上消失的技能;可以指定特定的技能名称,也可以加上 --yes 以非交互方式运行。
大小
10.6 MB
星标
341
时长
5个月
提交 · 90 天