Дата публикации
ai_products

Sx: пакетный менеджер для AI-навыков и MCP, который делит промпты на команды и команды на команды

Что нового

Sx — это open source‑пакетный менеджер не для кода, а для AI‑навыков: промптов, MCP‑серверов, slash‑команд, агентов и правил. Его задача — превратить разрозненные «фишки» ваших лучших разработчиков в общий пакет, который можно ставить как npm‑библиотеку.

Ключевые новшества:

  • Единый «vault» с AI‑активами: навыки, команды, правила, агенты, плагины, MCP‑серверы и хуки описываются в одном манифесте sx.toml.
  • Точное таргетирование установки: можно назначить, кто увидит конкретный навык — вся организация, конкретный репозиторий, путь в репо, команда, бот или один разработчик.
  • Поддержка почти всех популярных AI‑клиентов:
    • Claude Code, Cursor, GitHub Copilot, Gemini (CLI/VS Code, JetBrains, Android Studio), Cline, Codex, Kiro, Openclaw.
    • Веб‑версии claude.ai и chatgpt.com — через облачный relay skills.new.
  • Три модели дистрибуции:
    • локальный vault (личные проекты);
    • Git‑репозиторий для небольших команд;
    • Skills.new с веб‑интерфейсом и аналитикой для больших компаний.
  • Интеграция с skills.sh — каталогом из 85 000+ AI‑skills. Можно подтягивать готовые навыки и целые репозитории с ними.
  • Аналитика и аудит: Sx пишет usage‑события и изменения конфигурации в JSONL‑файлы. Есть CLI‑дашборд sx stats и аудит sx audit.
  • Поддержка уже настроенного Claude Code: можно «поднять» существующие промпты, команды и MCP‑конфиги из ~/.claude и начать версионировать их через sx.

Цифровых бенчмарков производительности или стоимости в проекте нет: Sx работает как оркестратор конфигов, а не как модель.

Как это работает

Sx заимствует логику npm/cargo/uv: есть манифест и lock‑файл, только вместо библиотек — AI‑навыки.

Манифест и lock‑файл

  • sx.toml — источник правды для vault:
    • список всех активов (skills, commands, rules, agents, hooks, MCP servers, plugins);
    • install‑scope для каждого: org, repo, path, team, bot, user;
    • определения команд: участники, админы, связанные репозитории.
  • Lock‑файл — персональный, лежит в ~/<cache>/sx/lockfiles/:
    • sx install читает sx.toml, сопоставляет команды и пользователей с git‑идентичностью вызывающего;
    • пишет итоговую конфигурацию в lock‑файл;
    • старые версии сохраняет с таймстампом, чтобы можно было воспроизвести прошлое состояние.

Vault и профили

Sx работает с несколькими vault‑ами через профили:

sx profile add work   # создать профиль
sx profile use work   # переключиться
sx profile list       # посмотреть все профили

Vault бывает трёх типов:

  • Локальный путь — личный каталог с активами:
sx init --type path --path my/vault/path
  • Git‑репозиторий — общий vault для небольшой команды:
sx init --type git --repo git@github.com:yourteam/skills.git
  • Skills.new (sleuth) — управляется через UI с аналитикой и discovery:
sx init --type sleuth

Scoping: кто видит какой навык

Sx даёт точный контроль установки через флаги:

sx install my-skill --org                     # все пользователи vault
sx install my-skill --repo github.com/acme/infra      # только внутри этого репо
sx install my-skill --path github.com/acme/infra#docs/ # только подкаталог docs
sx install my-skill --team platform           # все участники команды
sx install my-skill --user alice@acme.com     # конкретный пользователь (должен совпадать с git identity вызывающего)
sx install my-skill --bot python-backend      # бот (CI, агент), если SX_BOT=<name>

Сводка по scope:

  • --org — все пользователи vault, дефолт, если флаг не задан.
  • --repo / --path — пользователи, работающие внутри заданного репозитория или пути.
  • --team — только участники команды, доступ контролируют админы.
  • --user — один человек, git‑identity должен совпадать с вызывающим.
  • --bot — бот‑идентичность, определяется через SX_BOT=<name>.

Перед установкой можно сделать «сухой прогон» — аналог pip freeze без записи на диск:

sx install --dry-run

Cloud relay для claude.ai и chatgpt.com

Чтобы использовать свой vault в браузере на claude.ai или chatgpt.com, Sx поднимает MCP‑endpoint через skills.new:

sx cloud connect  # откроет skills.new, нужно вернуть attach-строку
sx cloud serve    # держать процесс запущенным, Ctrl+C — выход
sx cloud status   # покажет MCP URL для вставки в claude.ai / chatgpt.com

Релей работает по WebSocket, который открывает ваш компьютер. Контент vault остаётся локальным.

Аналитика и аудит

Sx пишет события в JSONL‑файлы внутри .sx/:

  • sx audit и sx audit --actor ... --since ... --event ... читают ./sx/audit/YYYY-MM.jsonl.
  • sx stats и sx stats --since 7d --json читают ./sx/usage/YYYY-MM.jsonl.

Примеры команд:

sx stats
sx stats --since 7d --json
sx audit
sx audit --actor alice@acme.com --since 30d --event install.set

Поддержка существующих настроек Claude Code

Если вы уже накопили промпты, skills и MCP‑конфиги в ~/.claude, их можно «затащить» в Sx:

# sx сам определит тип актива
sx add ~/.claude/commands/my-command
sx add ~/.claude/skills/my-skill
sx add code-review@claude-plugins-official

Файлы промптов остаются как есть, Sx добавляет к ним только метаданные для версионирования.

Что это значит для вас

Для кого Sx особенно полезен

  • Команды, которые плотно работают с Claude Code, Cursor, GitHub Copilot или Gemini. Если у вас уже есть «золотые» промпты и макросы, Sx превращает их в управляемый пакет.
  • Организации с несколькими репозиториями и командами. Можно раздавать общие правила код‑стайла и code review‑skills только тем, кому они реально нужны.
  • Инженеры, которые часто переезжают между машинами. Личный vault синхронизирует команду промптов и skills на всех устройствах.
  • Тимлиды и платформенные команды. Через scoping и аналитику можно увидеть, какие навыки реально используют, а какие висят мёртвым грузом.

Где Sx помогает

Примеры сценариев:

  • Единая AI‑«игротека» для команды. Лучшие промпты для code review, миграции схем, написания тестов, генерации документации живут в одном vault. Новый разработчик получает их в первый день через sx install.
  • Разные правила для разных репозиториев. В монорепозитории можно включать разные наборы правил и skills для фронтенда, бэкенда, инфраструктуры через --path.
  • Боты и CI. Sx умеет устанавливать навыки для ботов через --bot, а затем вы задаёте SX_BOT=<name> в CI. Один и тот же набор skills используют и люди, и агенты.
  • Эксперименты с внешними skills. Через skills.sh вы можете быстро подключить готовые пакеты, например:
sx add anthropics/skills/frontend-design
sx add vercel-labs/agent-skills
sx add --browse

Когда Sx может быть избыточен

  • У вас один небольшой репозиторий и один AI‑клиент, настройки живут в .claude или .cursor, и команда не меняется. В этом случае overhead от манифестов и vault может не окупиться.
  • Вы не используете Claude Code, Cursor, Copilot, Gemini или аналогичные клиенты. Sx завязан именно на них и на Model Context Protocol.

Доступность и ограничения

Sx — open source, распространяется через Homebrew и shell‑скрипт. Проект не вводит географических ограничений сам по себе.

Но есть нюанс: для интеграции с claude.ai, chatgpt.com и Skills.new вам могут понадобиться аккаунты Anthropic, OpenAI и доступ к skills.new. В ряде регионов для этого нужен VPN и банковские карты, которые принимают эти сервисы.

Если вы планируете использовать только локальный или Git‑vault и клиенты вроде Cursor или GitHub Copilot, Sx работает без веб‑части.

Место на рынке

Sx решает узкую, но болезненную задачу: управление AI‑навыками и промптами как пакетами. Прямых конкурентов с аналогичной моделью манифест+lock для skills сейчас немного.

Ближайшие альтернативы по подходу:

  • Локальные конфиги клиентов (~/.claude, .cursor, настройки Copilot):
    • плюс — простота, не нужен отдельный инструмент;
    • минус — нет версионирования, scoping по командам и репозиториям, централизованных обновлений.
  • Плагины и расширения IDE:
    • часто завязаны на один клиент или одну IDE;
    • требуют ручной установки на каждую машину;
    • не умеют таргетировать навыки по team/repo/path/bot.
  • Внутренние wiki и Notion‑страницы с промптами:
    • удобно читать, но неудобно подключать к AI‑клиентам;
    • нет гарантии, что разработчики используют актуальную версию промпта.

Sx отличается тем, что:

  • работает с множеством клиентов одновременно (Claude Code, Cursor, Copilot, Gemini и др.);
  • даёт тонкий контроль дистрибуции по организациям, репозиториям, путям, командам, ботам и людям;
  • интегрируется с skills.sh (85k+ skills) и Skills.new c discovery и аналитикой.

Чётких цифр по скорости работы относительно альтернатив нет: Sx — CLI‑утилита, которая в основном читает и пишет конфиги и JSONL‑логи. По стоимости он выигрывает тем, что сам по себе бесплатен, но общая цена владения зависит от того, какие AI‑клиенты и корпоративные сервисы вы подключаете.

Установка

Sx можно поставить через Homebrew (macOS/Linux) или через shell‑скрипт.

Homebrew

brew tap sleuth-io/tap
brew install sx

Shell‑скрипт

curl -fsSL https://raw.githubusercontent.com/sleuth-io/sx/main/install.sh | bash

Дальше — базовая инициализация и установка активов:

# Инициализация в текущем каталоге
sx init

# Добавить актив из vault
sx add /path/to/my-skill

# Установить активы в текущий проект
sx install

Как запустить и использовать

Базовый цикл работы

  1. Инициализируете vault (sx init, sx init --type git или sx init --type sleuth).
  2. Добавляете активы — промпты, команды, MCP‑серверы, плагины:
sx add /path/to/my-skill
sx add ~/.claude/commands/my-command
sx add ~/.claude/skills/my-skill
sx add code-review@claude-plugins-official
  1. Определяете scope установки через CLI:
sx install my-skill --org
sx install my-skill --repo github.com/acme/infra
sx install my-skill --path github.com/acme/infra#docs/
  1. Проверяете результат без установки:
sx install --dry-run
  1. Подключаете vault к AI‑клиентам — для десктопных IDE это происходит через локальные конфиги, для веб‑версий Claude и ChatGPT — через cloud relay.

Поддерживаемые клиенты

По состоянию на текущую версию Sx заявляет поддержку:

  • Claude Code — полный набор: skills, rules, commands, agents, MCP‑servers, hooks, плагины.
  • Cline — skills, rules, workflows как команды, MCP‑servers, hooks.
  • Codex — skills, commands, MCP‑servers.
  • Cursor — skills, rules, commands, MCP‑servers, hooks.
  • GitHub Copilot — skills, rules, commands, agents, MCP‑servers, локальные hooks.
  • Gemini (CLI/VS Code) — skills, rules, commands, MCP‑servers, hooks.
  • Gemini (JetBrains) — только rules и MCP‑servers, без commands/hooks.
  • Gemini (Android Studio) — rules и MCP‑remote по HTTP (без stdio).
  • Kiro — skills, rules, commands, MCP‑servers.
  • Openclaw — skills, rules, commands.
  • claude.ai (web) — через skills.new cloud relay.
  • chatgpt.com (web) — через skills.new cloud relay.

Что можно собирать и распространять через Sx

Типы активов:

  • Skills — промпты и поведение под конкретные задачи.
  • Rules — правила код‑стайла и гайды, привязанные к типам файлов или путям.
  • Agents — автономные агенты с заданными целями.
  • Commands — slash‑команды для быстрых действий.
  • Hooks — триггеры на события жизненного цикла (например, запуск сессии Claude Code).
  • MCP Servers (experimental) — сервера по Model Context Protocol для внешних интеграций.
  • Plugins — бандлы для Claude Code с командами, skills и другими компонентами.

Интеграция со skills.sh

Sx понимает формат skills.sh — каталога из 85 000+ AI‑навыков. Примеры:

sx add anthropics/skills/frontend-design   # добавить конкретный skill
sx add vercel-labs/agent-skills           # просмотреть skills в репозитории
sx add --browse                           # полнотекстовый поиск и просмотр каталога

Что дальше

В roadmap Sx уже реализовал:

  • локальные, Git и Skills.new‑vaults;
  • поддержку Claude Code, Cline, Cursor, GitHub Copilot, Gemini, Codex, Kiro, Openclaw;
  • подключение claude.ai и chatgpt.com через skills.new cloud relay;
  • установки для организаций, команд, ботов, репозиториев и персональных профилей для всех типов vault;
  • discovery навыков через Skills.new по коду и архитектуре;
  • аналитику использования skills.

Планы включают роль‑based access control и workflow запросов на изменения, чтобы обновления skills проходили через согласование.

Если вы уже живёте в экосистеме Claude Code, Cursor, Copilot или Gemini, Sx даёт способ перестать хранить важные промпты «под столом» и начать управлять ими как кодом.


Читайте также

🔗 Источник: https://github.com/sleuth-io/sx