# agents-debug

Скилл читает трейсы и логи AgentCore и находит причину ошибок, таймаутов и сбоев вызовов инструментов. Пригодится, когда агент отвечает неправильно или CLI не запускается.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 2000 установок · ★ 3282
- Автор: aws-agentcore
- Лицензия: Apache-2.0 · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/aws/agent-toolkit-for-aws/tree/HEAD/plugins/aws-agents/skills/agents-debug/SKILL.md
- Обновлён: 2026-10-23
- HTML: https://affpapa.org/nevibecode/skills/agents-debug

## Что делает

Скилл разбирает сбои по симптому. Если проблема в самом CLI — команда не находится, не хватает предварительных требований, — он открывает `references/doctor.md` и идёт по чек-листу. Если дело в поведении агента, начинает с `agentcore --version`: нужна версия не ниже 0.9.0, иначе сначала `agentcore update`.

Дальше скилл сам вытягивает данные. Список трейсов за последний час, последний trace ID, скачивание трейса, поиск по логам с уровнем error или по строке вроде `timeout`. Логи просить у разработчика не нужно — скилл читает их через `agentcore logs` и `agentcore traces get`. Имя агента берётся из `agentcore/agentcore.json`, если его не передали.

Отдельно разобран случай «model access denied»: модель может быть не включена в Bedrock для вашего региона, а если ID начинается с `us.`, `eu.`, `apac.` или `global.`, доступ нужен во всех регионах, которые покрывает профиль. Это стоит проверить до того, как копать в код агента. Для сбоев деплоя, настройки VPC и тюнинга производительности без ошибок есть другие скиллы — этот ими не занимается.

## Требования
- Работает с: AWS

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add aws/agent-toolkit-for-aws --skill agents-debug -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/agents-debug/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/agents-debug/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add aws/agent-toolkit-for-aws --skill agents-debug -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/agents-debug/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add aws/agent-toolkit-for-aws --skill agents-debug -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/agents-debug/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install aws/agent-toolkit-for-aws agents-debug
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/agents-debug/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add aws/agent-toolkit-for-aws --skill agents-debug -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/aws/agent-toolkit-for-aws --path plugins/aws-agents/skills/agents-debug
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/agents-debug/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add aws/agent-toolkit-for-aws --skill agents-debug -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/aws/agent-toolkit-for-aws/tree/HEAD/plugins/aws-agents/skills/agents-debug/SKILL.md

## Когда брать
- понять, почему агент возвращает ошибку или бессмысленный ответ
- найти упавший вызов инструмента в трейсе
- проверить, включён ли доступ к модели в Bedrock
- разобраться, почему логи не видны в CloudWatch
- проверить предварительные требования, когда не работает сам CLI

## Примеры запросов агенту
- /agents-debug traces
- /agents-debug doctor
- /agents-debug memory

## Похожие
- [aws-agentic-ai](https://affpapa.org/nevibecode/skills/aws-agentic-ai.md) — скилл · 650 установок
- [private-connectivity](https://affpapa.org/nevibecode/skills/private-connectivity.md) — скилл · 4100 установок
- [pulumi-debug-failed-operation](https://affpapa.org/nevibecode/skills/pulumi-debug-failed-operation.md) — скилл · 352 установки
- [dt-obs-network-flows](https://affpapa.org/nevibecode/skills/dt-obs-network-flows.md) — скилл · 912 установок
- [input-configurations](https://affpapa.org/nevibecode/skills/input-configurations.md) — скилл · 503 установки
- [render-debug](https://affpapa.org/nevibecode/skills/render-debug.md) — скилл · 541 установка

Из того же набора: [aws/agent-toolkit-for-aws](https://affpapa.org/nevibecode/by/aws/agent-toolkit-for-aws.md) — 133 карточки

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md