# Навыки

В Just Run слово **навык** обозначает две разные точки расширения. **Плагин Just Run** добавляет навыки, которые управляют Just Run из вашего Claude Code или Codex. **Навыки песочницы** устанавливаются внутрь песочницы для Claude Code, запущенного в гостевом окружении.

У них разные места установки, учетные данные и жизненные циклы. Установка одного не устанавливает другое.

## Навыки плагина и навыки песочницы[​](#plugin-skills-and-sandbox-skills "Прямая ссылка на Навыки плагина и навыки песочницы")

|                   | Навык плагина                                                    | Навык песочницы                                                                   |
| ----------------- | ---------------------------------------------------------------- | --------------------------------------------------------------------------------- |
| Потребитель       | Claude Code или Codex на вашем компьютере                        | Claude Code внутри песочницы Just Run                                             |
| Кто устанавливает | Менеджер плагинов Claude Code или Codex из маркетплейса Just Run | Асинхронная подготовка песочницы после загрузки                                   |
| Место установки   | Ваш профиль Claude Code или домашний каталог Codex               | `~/.claude/skills/` для пользователя песочницы по умолчанию                       |
| Источник          | Плагин Just Run: шесть навыков и подключение к MCP               | `SKILL.md`, написанный вручную, удаленный источник или результат поиска skills.sh |
| Авторизация       | Вход по OAuth в ваш аккаунт Just Run                             | Не выдает дополнительных прав платформы; установка выполняется внутри песочницы   |

## Плагин Just Run для Claude Code и Codex[​](#the-just-run-plugin-for-claude-code-and-codex "Прямая ссылка на Плагин Just Run для Claude Code и Codex")

Один плагин подключает Claude Code или Codex к MCP управления платформой Just Run и добавляет шесть навыков для частых задач. Вы описываете задачу в чате, навык ассистент выбирает сам.

```
claude plugin marketplace add ──► claude plugin install ──► /mcp → Authenticate
                                                                    │
                             «опубликуй эту папку как сайт» ────────┴──► skill ──► MCP just-run
```

### Установка и вход[​](#install-and-sign-in "Прямая ссылка на Установка и вход")

#### Claude Code[​](#claude-code "Прямая ссылка на Claude Code")

Нужен Claude Code 2.1.292 или новее. В терминале:

```
claude plugin marketplace add https://platform.just-run.app/plugins/marketplace.json
claude plugin install just-run@just-run
```

Внутри сессии Claude Code то же делают команды `/plugin marketplace add …` и `/plugin install just-run@just-run`.

Затем запустите `claude`, выполните `/mcp`, выберите сервер `plugin:just-run:just-run` и пункт *Authenticate*. В браузере откроется вход в Just Run; после согласия Claude Code работает с вашим аккаунтом. Создавать и вставлять токен не нужно, переменные окружения и локальные помощники плагину не нужны.

Подключение появится в разделе *Токены* веб-интерфейса Just Run, там его можно отозвать. Оно продлевается, пока Claude Code им пользуется, истекает после 30 дней без использования и не позже чем через 90 дней после согласия; после этого войдите снова.

Публичная страница *Кодинг-ассистенты* в веб-интерфейсе показывает эти команды для установки, с которой она открыта, с переключателем между Claude Code и Codex. Другая установка Just Run (on-prem, тестовый стенд) отдает свой маркетплейс по адресу `<ее адрес>/plugins/marketplace.json`, и плагин из него подключается к ней. Чтобы направить установленный плагин на другой адрес, выполните `claude plugin configure just-run` и задайте `base_url` без завершающего `/`.

#### Codex[​](#codex "Прямая ссылка на Codex")

Нужны Codex CLI 0.159 или новее и `git` в `PATH`: Codex забирает плагин как Git-репозиторий. Windows не проверялся, приложение Codex desktop еще проверяется. В терминале:

```
codex plugin marketplace add https://platform.just-run.app/plugins/codex.git
codex plugin add just-run@just-run
codex mcp login just-run
```

Вход: `codex mcp login just-run` открывает страницу входа Just Run в браузере; после входа начните новый сеанс Codex. Другая установка Just Run (on-prem, тестовый стенд) отдает свой репозиторий по адресу `<ее адрес>/plugins/codex.git`, и плагин из него подключается к этой установке. Настройки `base_url` в Codex нет: адрес берется оттуда, откуда плагин установлен. Чтобы держать две установки рядом, задайте каждой свой `CODEX_HOME`.

### Навыки[​](#the-skills "Прямая ссылка на Навыки")

| Навык                 | Что делает                                                                                                                                                |
| --------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `run-task`            | Разово выполняет команду, скрипт или ноутбук в песочнице и возвращает вывод и файлы с результатом                                                         |
| `automate-task`       | Создает и обслуживает автоматизации по расписанию cron и по вебхуку: проверка, изменение, пауза, удаление                                                 |
| `publish-site`        | Публикует готовый статический сайт — HTML или уже собранную папку — по публичной ссылке, обновляет по той же ссылке, откатывает и удаляет                 |
| `host-mcp-server`     | Разворачивает MCP-сервер из каталога Just Run или официального реестра MCP и дает команду для подключения                                                 |
| `manage-telegram-bot` | Пишет, разворачивает и обслуживает Telegram-бота: обновление, статус и логи, задания по расписанию, пересоздание, удаление                                |
| `troubleshoot`        | Выясняет по состоянию, событиям и логам, почему песочница, сайт, автоматизация или сервер Hosted MCP работают не так, и исправляет в рамках вашей просьбы |

Навык включается сам, когда запрос ему подходит; в Claude Code `/just-run:<skill>` запускает его явно. В Codex навыки называются `just-run:<skill>`. Все инструменты MCP Just Run доступны и напрямую, без навыка. `publish-site` пока не собирает проекты: соберите проект локально и опубликуйте готовую папку.

Публичный `GET /v1/skills/catalog` и MCP-инструмент `skills_catalog` отдают версию плагина, адрес маркетплейса, команды установки (Claude Code и Codex) и список навыков. См. [справочник REST API](/api-reference/rest.md).

Проверяйте запрошенную операцию

Навык — это инструкции, а не граница прав. Он действует с правами аккаунта, под которым вы вошли, поэтому проверяйте, что он собирается создать, открыть наружу или удалить. Токены ботов и другие учетные данные храните в [секретах](/secrets.md), а не в чате.

### Обновление и удаление[​](#updates-and-removal "Прямая ссылка на Обновление и удаление")

Плагин выходит вместе с релизом Just Run. В Claude Code, чтобы получить новую версию, выполните `claude plugin marketplace update just-run`, затем `claude plugin update just-run@just-run` и перезапустите Claude Code; удалить плагин — `claude plugin uninstall just-run@just-run` (или в `/plugin` внутри Claude Code). В Codex выполните `codex plugin marketplace upgrade`; удалить плагин можно командой `codex plugin remove just-run@just-run`. Удаление плагина не удаляет то, что его навыки создали в вашем аккаунте.

### Ограниченная сеть[​](#restricted-network "Прямая ссылка на Ограниченная сеть")

Облачная сессия Claude Code или локальная песочница может пропускать исходящие запросы только к разрешенным доменам. Добавьте в этот список хост Just Run (`platform.just-run.app` для публичного сервиса): он нужен и для установки плагина, и для каждой операции, потому что навыки работают через MCP-сервер на этом хосте.

## Навыки песочницы[​](#sandbox-skills "Прямая ссылка на Навыки песочницы")

Навыки песочницы относятся к созданию песочницы, а не к плагину Just Run. Добавляйте их в форму создания песочницы в веб-интерфейсе, [пресет шаблона](/templates/presets), REST `skills[]` или MCP `sandbox_create`.

```
inline content ───────┐
remote source ────────┼──► create sandbox ──► async `skills` step
skills.sh selection ──┘                             │
                                                   └──► ~/.claude/skills/
```

Схема создания принимает:

| Источник                                 | Поведение                                                                                           |
| ---------------------------------------- | --------------------------------------------------------------------------------------------------- |
| `content` с необязательным `name`        | Записывает содержимое напрямую как `<name>/SKILL.md`; при одновременном `url` приоритет у `content` |
| `url` или сокращенная запись репозитория | Выполняет `skills add <source> -y` внутри песочницы                                                 |
| Поиск skills.sh в веб-интерфейсе         | Преобразует выбранный результат в удаленный источник для того же установщика внутри песочницы       |

Если запись, введенная вручную, не содержит имя, компонент подготовки создает `custom-skill-<index>`. Удаленная установка поддерживает форматы источников, которые принимает CLI `skills` в выбранном шаблоне.

Маршрут поиска во внешнем skills.sh требует вошедшего пользователя Just Run. Его результаты не входят в плагин Just Run и не проверяются Just Run.

### Результат подготовки[​](#provisioning-outcome "Прямая ссылка на Результат подготовки")

Навыки устанавливаются после запуска VM. Поэтому успешное создание песочницы может вернуться при `provisioning.status: in_progress`. Перед использованием установленного навыка дождитесь терминального состояния подготовки.

Ошибки отдельных навыков песочницы считаются некритичными предупреждениями: они не удаляют песочницу, а шаг `skills` может завершиться как `ready` с предупреждениями. Проверяйте шаги подготовки, даже если сама песочница работает, а сводный статус подготовки — `ready`.

После подготовки навыки песочницы становятся обычными файлами конкретной песочницы. Они сохраняются вместе с ее файловой системой при остановке и возобновлении, но не становятся записями каталога уровня аккаунта.

### Безопасность источников и учетных данных[​](#source-and-credential-safety "Прямая ссылка на Безопасность источников и учетных данных")

Считайте каждый навык песочницы — введенный вручную или удаленный — кодом и инструкциями, доступными агенту внутри гостя:

* проверяйте источник и используйте стабильную ревизию, когда важна воспроизводимость;
* ожидайте сетевые запросы из песочницы при удаленной установке;
* используйте токены репозиториев с минимально необходимыми правами для приватных источников;
* не встраивайте секреты в `SKILL.md` или URL источников;
* передавайте учетные данные, нужные при выполнении, через [секреты](/secrets.md) и настройки окружения песочницы.

Установщик внутри песочницы передает удаленной установке только поддерживаемые переменные окружения с токенами Git, например `GITHUB_TOKEN`, `GH_TOKEN`, `GITLAB_TOKEN` и `GL_TOKEN`. Эти учетные данные остаются частью периметра безопасности песочницы.

## Точки входа[​](#entry-points "Прямая ссылка на Точки входа")

| Способ                                                    | Система навыков | Для чего                                                           |
| --------------------------------------------------------- | --------------- | ------------------------------------------------------------------ |
| Публичный веб-интерфейс → *Кодинг-ассистенты*             | Плагин          | Команды установки и список навыков                                 |
| `GET /v1/skills/catalog`, MCP `skills_catalog`            | Плагин          | Версия плагина, маркетплейс и навыки в машинном виде               |
| `GET /plugins/marketplace.json`                           | Плагин          | Маркетплейс, из которого устанавливает Claude Code                 |
| `GET /plugins/codex.git/info/refs`, `/HEAD`, `/objects/…` | Плагин          | Git-репозиторий только для чтения, из которого устанавливает Codex |
| Форма *Новая песочница* → *Навыки*                        | Песочница       | Искать, добавить удаленный источник или ввести содержимое вручную  |
| REST/MCP, создание песочницы, `skills[]`                  | Песочница       | Устанавливать навыки вместе с новой песочницей                     |
| REST `/v1/skills/search`                                  | Песочница       | Поиск с аутентификацией во внешнем каталоге skills.sh              |

## Подробнее о навыках[​](#explore-skills "Прямая ссылка на Подробнее о навыках")

* [Поиск навыков песочницы](/skills/sandbox-skills/discover) — skills.sh и прямые источники.
* [Добавление навыков в песочницу](/skills/sandbox-skills/add-to-a-sandbox) — подготовка при создании и статус.
* [Источники и версии](/skills/sandbox-skills/sources-and-versioning) — содержимое, введенное вручную, ссылки на удаленные источники и воспроизводимость.
* [Безопасность и разрешения](/skills/security-and-permissions) — доверие, учетные данные и границы выполнения.
* [Справочник REST API](/api-reference/rest.md) — каталог, поиск и схемы создания песочницы.
