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 полностью безопасным от них.
Для кого это сделано?Для разработчиков, которые используют ИИ-агентов для написания кода и имеют несколько установленных навыков в разных проектах, и которые хотят управлять ими, отлаживать и находить новые без ручного редактирования файлов.
Работает ли это на Windows или только на macOS и Linux?Поддерживаются macOS, Linux и Windows, для каждой системы есть отдельные инструкции по установке.
Команда doctor меняет мои навыки или файлы блокировки?Нет. Проверка состояния doctor只 читает данные и только выводит результаты; она никогда не меняет навыки и файлы блокировки.
Что на самом деле делает команда Doctor?Она формирует отчёт о состоянии текущего проекта без изменений: сначала выводит ошибки сканирования, потом предупреждения, а для каждого проблемного навыка показывает его путь и безопасный следующий шаг для исправления.
Можно ли найти новые навыки, не выходя из TUI?Да, LazySkills может искать навыки на skills.sh прямо внутри приложения, показать команду установки перед запуском и установить навык в проект или в глобальную область с подтверждением.
Какие виды поломанных установок он может обнаружить?Он подсвечивает отсутствующие файлы SKILL.md, некорректный frontmatter, битые символические ссылки, отсутствующие записи в файле блокировки и призрачные навыки агентов.
Можно ли восстановить навыки, если они пропали с диска?Да, `lazyskills restore` восстанавливает навыки, которые записаны в файле блокировки проекта или глобальном файле блокировки, но отсутствуют на диске. Можно указать конкретные имена навыков или запустить команду без вопросов с флагом --yes.
Какие есть похожие проекты?oh-my-hermes, gentle-ai, no-mistakes, skillshare, nuwa-skill, billion-context, agent-manager, ordewell
Автор
alvinunreal
Размер
10.6 MB
Звёзды
341
Возраст
5 мес
Коммиты · 90 дней