SkillNote CLI

SkillNote — самостоятельно разворачиваемый реестр SKILL.md с коллекциями на проект и синхронизацией в Claude Code и OpenClaw

  • 68 ★ репозитория
  • Последний коммит
CLI

Расширенный доступ

Почему такой уровень

  • Поднимает контейнеры Docker с Postgres и открывает локальные порты 3000 и 8082
  • Плагин и обертка в оболочке меняют запуск Claude Code на этой машине
Все причины и проверки

luna-prompts/skillnote

Установка

Работает в

Ручная установка

npx skillnote start

Нужны запущенный Docker и Node.js 20 или новее. Панель откроется на http://localhost:3000, API на порту 8082.

Доступ и проверки

Как мы проверяем

Расширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.

  • Поднимает контейнеры Docker с Postgres и открывает локальные порты 3000 и 8082
  • Плагин и обертка в оболочке меняют запуск Claude Code на этой машине

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

SkillNote поднимает у вас реестр скиллов: веб-интерфейс, API и Postgres в контейнерах. Команда npx skillnote start тянет образы из GHCR, ждет проверок здоровья и открывает панель на localhost:3000, API слушает порт 8082. Нужны запущенный Docker и Node.js 20 или новее. Идея проекта в том, что Claude Code делит около 8000 символов между описаниями всех активных скиллов, и после примерно 15 скиллов описания молча обрезаются. Коллекции на проект ограничивают набор до нужного. Правка в браузере доходит до подключенных агентов за 60 секунд, а агенты оценивают использованные скиллы от 1 до 5 с комментарием, из этого получается статистика полезности. К агентам реестр подключают командой npx skillnote connect claude-code: она добавляет плагин в ~/.claude/settings.json и ~/.claude/plugins/, ставит программу выбора коллекции и обертку в оболочке. Для OpenClaw есть clawhub install skillnote. Небольшое расширение для Chrome, по описанию автора, синхронизирует коллекции с плагинами в claude.ai.

Для кого. Командам, у которых скиллов Claude Code накопилось больше пятнадцати и нужно общее хранилище с версиями, коллекциями и приватными процедурами.

Подходит, если

  • Скиллы начали молча обрезаться, и непонятно, какие из них агент вообще видит
  • Новым коллегам надо показать, от каких скиллов зависит проект
  • Правку общего скилла нужно раздать всем без пересборки архива
  • Приватные процедуры деплоя и compliance не должны покидать вашу сеть
  • Нужна статистика, какие скиллы агенты оценивают высоко, а какие почти не используют

Не подходит, если

  • Скиллов мало и они лежат в ~/.claude/skills/ одного ноутбука: контейнеры и Postgres окажутся лишними
  • Docker на машине нельзя запускать: npx skillnote start работает только с Docker, для Podman есть путь через Compose
  • Нужен публичный каталог скиллов для всех: SkillNote рассчитан на ваш сервер
  • Агент не Claude Code и не OpenClaw: готовые подключения описаны для них

Пример запроса к агенту

Подними SkillNote у меня на машине, подключи его к Claude Code и создай коллекцию для этого проекта

Ограничения

  • Для запуска нужны Docker и Node.js 20 или новее, поднимаются веб-интерфейс, API и Postgres.
  • Команда npx skillnote `reset` --confirm стирает все данные.
  • Подключение к Claude Code правит ~/.claude/settings.json и добавляет плагин и обертку в оболочку, после этого нужно выполнить source ~/.zshrc.
  • По умолчанию реестр слушает localhost, доступ из локальной сети включает переменная SKILLNOTE_HOST.
  • Расширение Chrome для claude.ai в README описано как часть проекта, его подключение требует вашего решения.

Как отключить. Остановите реестр командой npx skillnote stop, тома сохранятся. Полное удаление данных делает npx skillnote `reset` --confirm. Плагин уберите из ~/.claude/plugins/skillnote/ и из ~/.claude/settings.json, обертку из ~/.zshrc.

Частые вопросы

Зачем нужен реестр, если скиллы можно хранить в ~/.claude/skills/?

Claude Code делит около 8000 символов между описаниями активных скиллов, и после примерно 15 штук описания обрезаются без предупреждения. Реестр с коллекциями на проект ограничивает набор, а правки доходят до всех агентов за 60 секунд.

Как запустить SkillNote?

Выполните npx skillnote start. Команда скачает образы, поднимет веб-интерфейс, API и Postgres и откроет http://localhost:3000. Альтернатива без Node: curl файла deploy/docker-compose.yml из репозитория и docker compose up -d.

Как подключить агентов?

Для Claude Code выполните npx skillnote connect claude-code и source ~/.zshrc, при первом запуске claude появится выбор коллекции. Для OpenClaw достаточно clawhub install skillnote.

Уходят ли скиллы за пределы моей сети?

Реестр самостоятельно разворачивается на вашей инфраструктуре, и по описанию автора скиллы остаются там. Исключение составляет расширение Chrome, которое по желанию синхронизирует коллекции с плагинами в вашем аккаунте claude.ai.

Как агенты оценивают скиллы?

После использования скилла агент ставит оценку от 1 до 5 и пишет комментарий. Из них складывается статистика, какие скиллы реально помогают.

Обсуждение

Вопросов и отзывов пока нет.

sync-skill копирует папки скиллов с SKILL.md между Claude Code, Codex, Cursor, Gemini CLI, Copilot, VS Code и OpenCode.

CLIРасширенный доступ96Звезды репозитория

Свыше 1100 готовых скиллов для Claude Code, Codex, Gemini CLI и Cursor и MCP-сервер, который подбирает скилл под задачу

СкиллРасширенный доступ200Звезды репозитория

CLI создает скиллы Claude с постепенной подгрузкой, проверяет размер и структуру, упаковывает в zip и ставит хуки активации

CLIРасширенный доступ88Звезды репозитория

Claude Code Skills and Agents

Claude Code Skills & Agents

Плагин Claude Code с набором скиллов и субагентов: глубокое исследование, генерация картинок, работа с GitHub, разбор кода и переключение моделей

ПлагинШирокий доступ1,7 тыс.Звезды репозитория

CLI и MCP для поиска и установки скиллов: проверяет SKILL.md линтером и отмечает обращения к сети, скриптам и секретам

CLIРасширенный доступ144Звезды репозитория

Девять личных скиллов инженера: цепочка от идеи до PR, поиск стандартов, песочница с циклом ревью и страницы-разборы изменений

СкиллРасширенный доступ170Звезды репозитория

Коротко о README

README начинается с проблемы лимита описаний, сравнивает жизнь с реестром и без него и дает быстрый старт одной командой. Дальше идут команды жизненного цикла, подключение Claude Code, OpenClaw и claude.ai, архитектура и ответы на вопросы. Сборка из исходников есть через install.sh.

Бейдж для README

Сообщить о проблеме