Claude Managed Agents — скилл
0xArx/claude-managed-agents-skillСкилл для Claude Code, который автоматически загружает актуальный контекст по Claude Managed Agents API: event loop, паттерны продакшена, MCP-аутентификация, отладка и оркестрация агентов. Для разработчиков, строящих автономных агентов на базе Anthropic.
Установка
git clone https://github.com/0xArx/claude-managed-agents-skill.gitREADME
Claude Managed Agents — скилл для Claude Code
Скилл для Claude Code, который даёт Claude глубокие, всегда доступные знания о Claude Managed Agents API — хостируемой инфраструктуре Anthropic для запуска Claude как автономного агента в облачном контейнере.
Вместо того чтобы каждый раз вставлять документацию или объяснять API вручную, скилл автоматически загружает нужный контекст, когда вы работаете с managed agents.
Официальная документация: platform.claude.com/docs/en/managed-agents/overview Этот скилл — структурированное дополнение к документации, сфокусированное на паттернах, подводных камнях и продакшен-использовании. Для актуальных изменений API, новых возможностей и полного справочника всегда обращайтесь к официальной документации.
Что охватывает скилл
| Тема | Где |
|---|---|
| Создание Agent / Environment / Session | SKILL.md |
Event loop, порядок стримов, обработка stop_reason | SKILL.md + references/events.md |
| Все типы событий (user ↔ agent ↔ session ↔ span) | references/events.md |
| Встроенные инструменты, кастомные инструменты, разрешения | references/tools.md |
| Интеграция MCP-сервера (двухшаговый паттерн аутентификации) | references/tools.md + references/vaults-and-mcp.md |
| Vaults и управление учётными данными | references/vaults-and-mcp.md |
| Спецификации контейнера, предустановленные рантаймы, структура файловой системы | references/container-reference.md |
| CRUD сессий, поля usage/stats, управление ресурсами в ходе сессии | references/session-management.md |
| Outcomes, мультиагентная оркестрация, Memory Stores (research preview) | references/research-preview.md |
| Проектирование системных промптов для агентов, мониторинг затрат, отладка, тестирование, скрытые сбои | references/production-patterns.md |
| Rate limits, требования к брендингу, типичные ошибки | SKILL.md |
Установка
Вариант 1 — Клонировать напрямую в папку скиллов
git clone https://github.com/0xArx/claude-managed-agents-skill \
~/.claude/skills/claude-managed-agentsВариант 2 — Скопировать вручную
Скачайте или клонируйте репозиторий, затем скопируйте папку:
cp -r claude-managed-agents-skill ~/.claude/skills/claude-managed-agents
Вариант 3 — Однострочная команда (curl)
mkdir -p ~/.claude/skills && \
curl -L https://github.com/0xArx/claude-managed-agents-skill/archive/refs/heads/main.tar.gz \
| tar -xz -C ~/.claude/skills --strip-components=1 \
--one-top-level=claude-managed-agentsГотово. Claude Code автоматически подхватывает скиллы из ~/.claude/skills/ — перезапуск не нужен.
Требования
- Claude Code — любая актуальная версия
ANTHROPIC_API_KEYс доступом к бетеmanaged-agents-2026-04-01
Примечание: Бета managed agents пока доступна не всем. Если у вас нет доступа, запросите его здесь.
Как это работает
Claude Code использует систему прогрессивного раскрытия для скиллов:
nameиdescriptionскилла всегда находятся в контексте — Claude использует их, чтобы решить, когда активировать скилл.SKILL.mdзагружается полностью при каждой активации скилла — охватывает полный процесс разработки.- Справочные файлы (
references/) загружаются по требованию, когда Claude нужны детали по конкретной теме.
Это означает, что скилл практически не расходует контекст, когда не используется, и загружает ровно то, что нужно, когда используется.
Когда активируется скилл?
Скилл активируется автоматически, когда вы:
- Спрашиваете о
client.beta.agents,client.beta.sessionsилиclient.beta.environments - Хотите стримить события агента или построить event loop
- Спрашиваете о политиках разрешений инструментов, кастомных инструментах или MCP-коннекторах
- Упоминаете outcomes, мультиагентную оркестрацию или memory stores
- Спрашиваете, как запускать Claude для длительных или асинхронных задач
- Хотите, чтобы Claude автономно выполнял bash-команды, записывал файлы или просматривал веб в контейнере
Структура файлов
claude-managed-agents/
├── SKILL.md # Основной скилл — загружается при каждой активации
└── references/
├── events.md # Полный справочник типов событий + паттерн event loop
├── tools.md # Встроенные инструменты, кастомные инструменты, настройка MCP
├── vaults-and-mcp.md # Жизненный цикл Vault, типы учётных данных, MCP-аутентификация
├── container-reference.md # Спецификации контейнера, рантаймы, структура файловой системы
├── session-management.md # CRUD сессий, usage/stats, ресурсы в ходе сессии
├── research-preview.md # Outcomes, Multiagent, Memory Stores
└── production-patterns.md # Системные промпты, мониторинг затрат, отладка, тестирование
Ключевые знания, которые получит Claude
Большинство ошибок при работе с managed agents возникают из-за нескольких неочевидных паттернов. Этот скилл обучает Claude всем из них:
Порядок стримов — Открывайте event stream до отправки сообщения, а не после. API буферизует события, но race conditions в Python реальны.
stop_reason при каждом idle — session.status_idle срабатывает как когда агент завершил работу, так и когда ему нужен ваш ввод (подтверждение инструмента, результат кастомного инструмента). Всегда проверяйте stop_reason.type.
Разделение MCP-аутентификации — URL сервера указывается в определении агента. Учётные данные помещаются в Vault, подключаемый при создании сессии. Никогда не передавайте токены аутентификации напрямую агенту.
Версионирование агента — Каждый вызов agent.update() увеличивает версию. Необходимо передавать текущую version обратно, иначе обновление завершится ошибкой.
Зависание кастомного инструмента — Если вы определили кастомный инструмент и не обрабатываете agent.custom_tool_use в event loop, агент молча ждёт вечно.
Ротация GitHub-токена — Обновляйте GitHub-ресурс в ходе сессии через sessions.resources.update(). Удалять и пересоздавать сессию не нужно.
session.deleted завершает стрим — Если сессия удалена во время прослушивания, стрим завершится. Обрабатывайте это событие явно.