Skip to content
Back to search

lazyskills

mission control for agent skills

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/alvinunreal--lazyskills/badge.svg)](/listings/alvinunreal--lazyskills)

HTML

<a href="/listings/alvinunreal--lazyskills"><img src="/api/listings/alvinunreal--lazyskills/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

These steps run a script from the network that findsafeskills does not scan.

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

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 180 lines · 2 findings marked

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <div align="center">
  2. <img src="assets/lazyskills-wide.svg" alt="Lazy Skills" width="640">
  3. # Lazy Skills
  4. **Blazing-fast mission control for agent skills.**
  5. [![CI](https://img.shields.io/github/actions/workflow/status/alvinunreal/lazyskills/ci.yml?branch=main&style=flat-square&label=CI&labelColor=0f172a&color=3dbbff)](https://github.com/alvinunreal/lazyskills/actions/workflows/ci.yml)
  6. [![Go Report Card](https://goreportcard.com/badge/github.com/alvinunreal/lazyskills?style=flat-square)](https://goreportcard.com/report/github.com/alvinunreal/lazyskills)
  7. [![Release](https://img.shields.io/github/v/release/alvinunreal/lazyskills?style=flat-square&labelColor=0f172a&color=ff79f2)](https://github.com/alvinunreal/lazyskills/releases/latest)
  8. [![Go](https://img.shields.io/github/go-mod/go-version/alvinunreal/lazyskills?style=flat-square&logo=go&logoColor=white&label=Go&labelColor=0f172a&color=3dbbff)](go.mod)
  9. [![License](https://img.shields.io/badge/license-MIT-b253f5?style=flat-square&labelColor=0f172a)](LICENSE)
  10. [![Stars](https://img.shields.io/github/stars/alvinunreal/lazyskills?style=flat-square&labelColor=0f172a&color=556bf4)](https://github.com/alvinunreal/lazyskills/stargazers)
  11. <img src="assets/banner.webp" alt="Lazy Skills - mission control for agent skills. Stay lazy." width="100%">
  12. _"I don't debug broken skills by hand - I have a TUI to be disappointed for me."_
  13. </div>
  14. ## 🌴 Overview
  15. 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.
  16. <div align="center">
  17. <img src="assets/demo.gif" alt="Lazy Skills terminal UI demo" width="100%">
  18. </div>
  19. ## ✨ Features
  20. - **See every skill in one place** - project, global, universal, and agent-specific skills in a single TUI.
  21. - **Check agent visibility** - switch agents and see which skills are actually usable by Claude Code, OpenCode, Codex, Cursor, Gemini CLI, and many more.
  22. - **Spot broken installs fast** - highlights missing `SKILL.md`, invalid frontmatter, broken symlinks, missing lock entries, and ghost agent skills.
  23. - **Preview before you act** - inspect metadata, rendered skill content, and the exact command LazySkills is about to run.
  24. - **Safe skill actions** - open, reinstall/update, remove, prune orphaned locks, or run bulk updates/removals with confirmation prompts.
  25. - **Discover more from a source** - scan local checkouts or GitHub skill sources to find skills you have not installed yet.
  26. - **Find and install new skills** - search skills.sh from inside LazySkills, preview the install command, then install to project or global scope with confirmation.
  27. ## 🛠️ Install
  28. Recommended for macOS and Linux:
  29. ```bash
  30. curl -fsSL https://lazyskills.sh/install | sh
    • Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
    • Line 47 on GitHub
  31. ```
  32. Or use Homebrew:
  33. ```bash
  34. brew install --cask alvinunreal/tap/lazyskills
  35. ```
  36. Windows:
  37. ```powershell
  38. irm https://lazyskills.sh/install.ps1 | iex
  39. ```
  40. Go users:
  41. ```bash
  42. go install github.com/alvinunreal/lazyskills/cmd/lazyskills@latest
  43. ```
  44. Then launch it:
  45. ```bash
  46. lazyskills
  47. ```
  48. ## 🚀 Getting started
  49. Run LazySkills from a project:
  50. ```bash
  51. lazyskills
  52. ```
  53. 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.
  54. Useful keys:
  55. | Key | What it does |
  56. | --- | --- |
  57. | `/` | Search skills |
  58. | `a` | Cycle through agent visibility filters |
  59. | `f` | Toggle project/global/all scopes |
  60. | `enter` | Open details for a skill or source |
  61. | `c` | Show available actions |
  62. | `n` | Find new skills from skills.sh |
  63. | `space` | Select a skill for bulk actions |
  64. | `u` | Reinstall/update selected skill |
  65. | `x` | Remove selected skill |
  66. | `?` | Show the full keymap |
  67. LazySkills previews actions before running them, and destructive actions require confirmation.
  68. For agent-friendly registry search without opening the TUI:
  69. ```bash
  70. lazyskills find --json "browser automation"
  71. ```
  72. ### Doctor
  73. Run a read-only health report for the current project:
  74. ```bash
  75. lazyskills doctor
  76. ```
  77. 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:
  78. ```bash
  79. lazyskills doctor --json
  80. lazyskills doctor --cwd /path/to/project
  81. ```
  82. 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.
  83. ### Restore from lock files
  84. Restore skills that are recorded in the project or global lock file but missing from disk:
  85. ```bash
  86. lazyskills restore --global
  87. lazyskills restore --project
  88. lazyskills restore --all
  89. ```
  90. Pass skill names to restore only those entries, or `--yes` to accept the preview non-interactively:
  91. ```bash
  92. lazyskills restore --project code-review tdd
  93. lazyskills restore --global --yes
  94. ```
  95. 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.
  96. ## 🔄 Updates
  97. LazySkills can check for new releases and show the command to update your installation manually.
  98. ### CLI Update
  99. Run the update command directly from your terminal to check for updates and get upgrade instructions:
  100. ```bash
  101. lazyskills update
  102. ```
  103. Options:
  104. * `--check`: Query if a newer version is available. Exits 0 if status is checked cleanly.
  105. * `--print-command`: Print the command required to upgrade on your channel (e.g. `brew upgrade`) and exit.
  106. ### TUI Update
  107. When a newer version of LazySkills is available, an update notification will appear in the TUI footer:
  108. `· U update (vX.Y.Z available)`
  109. 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.
  110. ## ⭐ Star for a chance to win stickers
  111. <div align="center">
  112. <img src="assets/stickers.webp" alt="Lazy Skills stickers" width="100%">
  113. </div>
  114. 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.
  115. 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.
  116. ## 📄 License
  117. MIT - see [LICENSE](LICENSE).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.