Mission control for agent skills.
"I don't debug broken skills by hand - I have a TUI to be disappointed for me."
🌴 Overview
LazySkills is a 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.
✨ Features
- See every skill in one place - project, global, universal, and agent-specific skills in a single TUI.
- Check agent visibility - switch agents and see which skills are actually usable by Claude Code, OpenCode, Codex, Cursor, Gemini CLI, and many more.
- Spot broken installs fast - highlights missing
SKILL.md, invalid frontmatter, broken symlinks, missing lock entries, and ghost agent skills. - Preview before you act - inspect metadata, rendered skill content, and the exact command LazySkills is about to run.
- Safe skill actions - open, reinstall/update, remove, prune orphaned locks, or run bulk updates/removals with confirmation prompts.
- Discover more from a source - scan local checkouts or GitHub skill sources to find skills you have not installed yet.
🛠️ Install
Recommended for macOS and Linux:
curl -fsSL https://raw.githubusercontent.com/alvinunreal/lazyskills/main/scripts/install.sh | sh
Or use Homebrew:
brew install --cask alvinunreal/tap/lazyskills
irm https://raw.githubusercontent.com/alvinunreal/lazyskills/main/scripts/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 |
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.
⭐ Star for a chance to win 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.
Comments