braintrust-analyze — скилл для Claude Code: что делает
Скилл анализирует трейсы сессий Claude Code через Braintrust. Находит зацикливания инструментов, оценивает расход токенов и показывает статистику по вызовам агентов.
npx skills add parcadei/Continuous-Claude-v3 --skill braintrust-analyze -a claude-codeЧто делает braintrust-analyze
Скилл даёт готовые команды для анализа телеметрии Braintrust после сложных задач или сбоев. Скрипт scripts/braintrust_analyze.py запускается через uv run python -m runtime.harness и собирает сводки по вызовам утилит, распределению токенов и переходам между субагентами вроде plan-agent или debug-agent.
Флаг --detect-loops выявляет проблемы: он ищет ситуации, когда агент вызывал один и тот же инструмент больше 5 раз подряд. Также доступны отчёты --weekly-summary, просмотр тренда токенов через --token-trends и пошаговое воспроизведение конкретной сессии по её идентификатору с помощью --replay <session-id>.
Без переменной BRAINTRUST_API_KEY в ~/.claude/.env или в .env проекта и без плагина braintrust-claude-plugin скрипт останется бесполезным, так как данным неоткуда будет взяться. По умолчанию выборка идёт из проекта Braintrust с именем agentica, если не переопределить параметр --project.
Какие задачи решает
- выявить зацикливания агента при вызове одного инструмента больше 5 раз подряд
- разобрать причины сбоев и шаги работы в недавней сессии
- собрать еженедельный отчёт по активности и расходу токенов
- посмотреть статистику запусков субагентов и скиллов за последние 7 дней
Примеры запросов агенту
- Проанализируй мою последнюю сессию через braintrust-analyze
- Проверь через braintrust_analyze.py, не зацикливались ли вызовы инструментов
- Покажи статистику использования агентов и скиллов за последние 7 дней
Как установить braintrust-analyze
1Через Skills CLI (Vercel)
npx skills add parcadei/Continuous-Claude-v3 --skill braintrust-analyze -a claude-code2Вручную: положить файлы
~/.claude/skills/braintrust-analyze/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/braintrust-analyze/
1Через Skills CLI (Vercel)
npx skills add parcadei/Continuous-Claude-v3 --skill braintrust-analyze -a codex2Вручную: положить файлы
.agents/skills/braintrust-analyze/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add parcadei/Continuous-Claude-v3 --skill braintrust-analyze -a cursor2Вручную: положить файлы
.cursor/skills/braintrust-analyze/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install parcadei/Continuous-Claude-v3 braintrust-analyze2Вручную: положить файлы
.github/skills/braintrust-analyze/SKILL.md1Через Skills CLI (Vercel)
npx skills add parcadei/Continuous-Claude-v3 --skill braintrust-analyze -a gemini-cli2Командой платформы
gemini skills install https://github.com/parcadei/Continuous-Claude-v3 --path .claude/skills/braintrust-analyzeВручную: положить файлы
.devin/skills/braintrust-analyze/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add parcadei/Continuous-Claude-v3 --skill braintrust-analyze -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Из того же набора69
Похожие
Рядом в теме «Настройка агента: память, контекст, субагенты»
Все скиллы по теме «Настройка агента: память, контекст, субагенты» →Вопросы о braintrust-analyze
Как установить braintrust-analyze в Claude Code?
Выполните команду npx skills add parcadei/Continuous-Claude-v3 --skill braintrust-analyze -a claude-code. Файл навыка сохранится в ~/.claude/skills/braintrust-analyze/SKILL.md.
Что делает скилл braintrust-analyze?
Он разбирает трейсинг Braintrust для сессий Claude Code. Инструмент показывает использование утилит, оценивает расход токенов и находит зацикливания при выполнении задач.
Что нужно настроить перед запуском анализа?
Потребуется ключ BRAINTRUST_API_KEY в файле ~/.claude/.env или .env проекта, а также включённый сбор трейсов через braintrust-claude-plugin.
Исходный текст
SKILL.md · MIT
--- name: braintrust-analyze description: Analyze Claude Code sessions via Braintrust --- # Braintrust Analysis Analyze your Claude Code sessions for patterns, issues, and insights using Braintrust tracing data. ## When to Use - After completing a complex task (retrospective) - When debugging why something failed - Weekly review of productivity patterns - Finding opportunities to create new skills - Understanding token usage trends ## Commands Run from the project directory: ```bash # Analyze last session - summary with tool/agent/skill breakdown uv run python -m runtime.harness scripts/braintrust_analyze.py --last-session # List recent sessions uv run python -m runtime.harness scripts/braintrust_analyze.py --sessions 5 # Agent usage statistics (last 7 days) uv run python -m runtime.harness scripts/braintrust_analyze.py --agent-stats # Skill usage statistics (last 7 days) uv run python -m runtime.harness scripts/braintrust_analyze.py --skill-stats # Detect loops - find repeated tool patterns (>5 same tool calls) uv run python -m runtime.harness scripts/braintrust_analyze.py --detect-loops # Replay specific session - show full sequence of actions uv run python -m runtime.harness scripts/braintrust_analyze.py --replay <session-id> # Weekly summary - daily activity breakdown uv run python -m runtime.harness scripts/braintrust_analyze.py --weekly-summary # Token trends - usage over time uv run python -m runtime.harness scripts/braintrust_analyze.py --token-trends ``` ## Options - `--project NAME` - Braintrust project name (default: agentica) ## What You'll Learn ### Session Analysis - Tool usage breakdown - Agent spawns (plan-agent, debug-agent, etc.) - Skill activations (/commit, /research, etc.) - Token consumption estimates ### Loop Detection Find sessions where the same tool was called repeatedly, which may indicate: - Stuck in a search loop - Inefficient approach - Opportunity for better tooling ### Usage Patterns - Which agents you use most - Which skills get activated - Daily/weekly activity trends ## Examples ### Quick Retrospective ```bash # What happened in my last session? uv run python -m runtime.harness scripts/braintrust_analyze.py --last-session ``` Output: ``` ## Session Analysis **ID:** `92940b91...` **Started:** 2025-12-24T01:31:05Z **Spans:** 14 ### Tool Usage - Read: 4 - Bash: 2 - Edit: 2 ... ``` ### Find Loops ```bash uv run python -m runtime.harness scripts/braintrust_analyze.py --detect-loops ``` ### Weekly Review ```bash uv run python -m runtime.harness scripts/braintrust_analyze.py --weekly-summary ``` ## Requirements - BRAINTRUST_API_KEY in ~/.claude/.env or project .env - Braintrust tracing enabled (via braintrust-claude-plugin)
© parcadei · MIT · parcadei/Continuous-Claude-v3