mission control for agent skills
Go agent-skillsagent-toolsai-agentsai-toolsai-workflowclaude-codeclicoding-agentscommand-line-tooldeveloper-toolsgoopencodeproductivity-toolsskill-discoveryskill-managementskillsterminal-appterminal-uituiworkflow-automation
Add demo GIF and update README
Alvin Unreal1ad1e673d0d6
diff --git a/README.md b/README.mdindex 3a3fd56..8b89afa 100644--- a/README.md+++ b/README.md@@ -21,232 +21,94 @@ _"I don't debug broken skills by hand - I have a TUI to be disappointed for me."## π΄ Overview-LazySkills is a terminal UI for agent skills. It shows what skills are installed, which agents can see them, why visibility may be broken, and provides guarded actions for common skill operations, all from one screen.--## β Star for a chance to win stickers+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.<div align="center">-<img src="assets/stickers.webp" alt="Lazy Skills stickers" width="100%">+<img src="assets/demo.gif" alt="Lazy Skills terminal UI demo" width="100%"></div>-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](https://github.com/alvinunreal/lazyskills/issues/2), tagged by their GitHub username, so you'll get a notification if it's you. Shipping details are arranged privately from there.-## β¨ Features-β Fast, keyboard-driven Bubble Tea TUI-β Project and global skill inventory-β Agent compatibility diagnostics based on the upstream `skills` registry-β Visibility reasons per agent, including missing links, broken symlinks, unsupported global installs, and ghost agent-directory skills-β `SKILL.md` preview with safe terminal sanitization-β Responsive panes and scrollable details-β Source/repo group headers in the skill list-β Guarded actions: refresh/rescan, open in `$EDITOR`, reinstall/update, remove, and bulk update/remove via the official `skills` CLI-β Source/repo-aware selection for grouped workflows-β Structured command execution with confirmation, captured output, and rescan after successful mutations--## π οΈ Installation+- **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.-### Homebrew--```bash-brew install --cask alvinunreal/tap/lazyskills-```+## π οΈ Install-### macOS / Linux install script+Recommended for macOS and Linux:```bashcurl -fsSL https://raw.githubusercontent.com/alvinunreal/lazyskills/main/scripts/install.sh | sh```-The script installs to `/usr/local/bin` by default and verifies the release checksum. To install somewhere else:+Or use Homebrew:```bash-curl -fsSL https://raw.githubusercontent.com/alvinunreal/lazyskills/main/scripts/install.sh | sh -s -- -b ~/.local/bin-```--### Windows PowerShell--```powershell-iwr https://raw.githubusercontent.com/alvinunreal/lazyskills/main/scripts/install.ps1 -useb | iex-```--The PowerShell installer installs to `%LOCALAPPDATA%\Programs\lazyskills\bin` and adds it to your user PATH.--### Windows Scoop--```powershell-scoop bucket add alvinunreal https://github.com/alvinunreal/scoop-bucket-scoop install lazyskills+brew install --cask alvinunreal/tap/lazyskills```-### Windows WinGet+Windows:```powershell-winget install alvinunreal.lazyskills+irm https://raw.githubusercontent.com/alvinunreal/lazyskills/main/scripts/install.ps1 | iex```-WinGet availability may lag behind GitHub Releases because new versions are submitted to `microsoft/winget-pkgs` as pull requests.--### Go+Go users:```bashgo install github.com/alvinunreal/lazyskills/cmd/lazyskills@latest```-### Nix experimental--Run directly from GitHub:--```bash-nix run github:alvinunreal/lazyskills-```--Or from a local checkout:--```bash-nix run-```--### Manual download--Download a binary archive from [GitHub Releases](https://github.com/alvinunreal/lazyskills/releases), verify it with `checksums.txt`, and place `lazyskills` on your PATH.--### Linux packages--LazySkills publishes `.deb` and `.rpm` packages for Linux amd64 and arm64 releases.--Debian / Ubuntu:--```bash-curl -LO https://github.com/alvinunreal/lazyskills/releases/download/v0.1.1/lazyskills_0.1.1_linux_amd64.deb-sudo apt install ./lazyskills_0.1.1_linux_amd64.deb-```--Fedora / RHEL / openSUSE:--```bash-curl -LO https://github.com/alvinunreal/lazyskills/releases/download/v0.1.1/lazyskills_0.1.1_linux_amd64.rpm-sudo dnf install ./lazyskills_0.1.1_linux_amd64.rpm-```--Use the `arm64` package instead on ARM Linux machines.--### Build from source--```bash-go build -o lazyskills ./cmd/lazyskills-```--Then run:+Then launch it:```bash-./lazyskills+lazyskills```-Or scan as JSON:+## π Getting started-```bash-./lazyskills scan --json-./lazyskills scan --json --cwd /path/to/project-```--Check the installed version:+Run LazySkills from a project:```bash-lazyskills version+lazyskills```-## β¨οΈ Usage--```bash-lazyskills [--cwd <path>]-lazyskills scan --json [--cwd <path>]-```+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.-Common TUI keys:+Useful keys:-| Key | Action |+| Key | What it does || --- | --- |-| `β/β`, `j/k` | Move selection (Inventory) or scroll (Metadata/Preview) |-| `gg` / `G` | Jump to top / bottom (also `home` / `end`) |-| `1` / `2` / `3` | Focus the Inventory / Metadata / Preview pane |-| `tab`, `shift+tab` | Cycle focus through panes |-| `β/β` | Jump source groups (Inventory) or switch pane focus |-| `h/l` (`-`/`+`) | Collapse / expand the current source group |-| `[` / `]` | Jump to previous / next source group |-| `f` / `F` | Cycle scope filter (All/Project/Global) / reset to All |-| `a` / `A` | Cycle agent filter / reset to all agents || `/` | Search skills |-| `space` | Mark/unmark skill for bulk actions |-| `s` | Mark all skills from the current source/repo |-| `o` | Open current skill in `$EDITOR` |-| `u` / `x` | Update / remove current skill (or marked skills if any) |-| `c` | Show guarded actions |-| `enter` | Open detail for the selection (runs the action in the command picker) |-| `d` | Discover available skills for the selected source |-| `r` | Refresh scan |-| `?` | Toggle help |-| `q` | Quit |--Mutating actions open a centered confirmation prompt. Press Enter for the default yes, or type `y`, `yes`, or the displayed phrase. Press `n` or Esc to cancel.--The skill list groups adjacent skills by source/repo when lock metadata is available. Skill details also show the exact folder and ref. Use `s` to mark every skill from the current source/repo, then `u` or `x` to update or remove that group with confirmation.--## β‘ How actions work--LazySkills delegates install/update/remove behavior to the official `skills` CLI. It resolves commands as:+| `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 |-1. `skills` if available on `PATH`-2. `npx --yes skills` as fallback+LazySkills previews actions before running them, and destructive actions require confirmation.-Commands are executed as structured argv, not shell strings. Output is captured, sanitized, capped, and displayed in the TUI. Successful mutations trigger a rescan.-## π€ Supported agents--LazySkills mirrors the upstream `vercel-labs/skills` agent registry, including universal `.agents/skills` agents, agent-specific skill directories, global support, and installed-agent detection heuristics.--The registry is manually ported for now. A generated parity check is a planned follow-up.--## π Safety and limitations--- LazySkills does not reimplement remote clone/install/update/remove logic in Go.-- Search/marketplace flows are not implemented.-- `skills use` integration is not implemented.-- Agent cycling is functional but not yet a searchable picker.--## π§ͺ Development--```bash-go test ./...-go build ./cmd/lazyskills-```--## π’ Releases--LazySkills uses [GoReleaser](https://goreleaser.com/) to publish cross-platform binaries, checksums, GitHub Releases, and the Homebrew formula.--Release a new version by pushing a SemVer tag:+## β Star for a chance to win stickers-```bash-git tag v0.1.0-git push origin v0.1.0-```+<div align="center">-The release workflow builds:+<img src="assets/stickers.webp" alt="Lazy Skills stickers" width="100%">-- macOS Intel and Apple Silicon-- Linux amd64 and arm64-- Windows amd64 and arm64-- Linux `.deb` and `.rpm` packages+</div>-Nix users can run LazySkills with `nix run github:alvinunreal/lazyskills` once the flake dependency hash is finalized.+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.-Homebrew publishing requires the repository secret `HOMEBREW_TAP_GITHUB_TOKEN` with permission to push to `alvinunreal/homebrew-tap`.+Winners are drawn from stargazers and announced in the [sticker giveaway issue](https://github.com/alvinunreal/lazyskills/issues/2), tagged by their GitHub username, so you'll get a notification if it's you. Shipping details are arranged privately from there.-Scoop publishing requires the repository secret `SCOOP_BUCKET_GITHUB_TOKEN` with permission to push to `alvinunreal/scoop-bucket`.+## π License-WinGet publishing requires the repository secret `WINGET_TOKEN`, a classic GitHub token with `public_repo` scope. The first WinGet submission may need to be created manually before automated updates are accepted.+MIT β see [LICENSE](LICENSE).diff --git a/assets/demo.gif b/assets/demo.gifnew file mode 100644index 0000000..09dc2b8Binary files /dev/null and b/assets/demo.gif differ