К основному содержанию
скилл CX Codex

braintrust-analyze — скилл для Claude Code: что делает

Скилл анализирует трейсы сессий Claude Code через Braintrust. Находит зацикливания инструментов, оценивает расход токенов и показывает статистику по вызовам агентов.

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add parcadei/Continuous-Claude-v3 --skill braintrust-analyze -a claude-code
Открыть на GitHub

Что делает 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-code

2Вручную: положить файлы

~/.claude/skills/braintrust-analyze/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/braintrust-analyze/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Из того же набора69

research Исследует кодовую базу и описывает текущую архитектуру без критики и рефакторинга. Запускает субагентов для анализа файлов и сохраняет отчёт в каталог thoughts. CX Codex +1 485установок search-router Подсказывает агенту, каким инструментом искать код: TLDR, AST-grep, семантикой или Grep. Экономит токены на разведке по репозиторию. CX Codex +1 485установок fix Скилл-оркестратор: разбирает баг по цепочке от диагностики до коммита. Пригодится, когда непонятно, с чего начать починку. CX Codex +1 484установок qlty-check Скилл гоняет qlty CLI по вашему коду: линтеры, автофикс, форматирование и метрики сложности. Пригодится перед коммитом или передачей работы. CX Codex +1 484установок pint-compute Считает величины с единицами через Pint: переводит меры, проверяет размерности и упрощает составные единицы. Нужен для расчётов, где нельзя смешивать несовместимые величины. CX Codex +1 482установок release Прогоняет релиз через пять субагентов: аудит безопасности, E2E-тесты, финальное ревью, бамп версии и релизные заметки. Пригодится перед выкладкой в прод. CX Codex +1 481установок tldr-deep Скилл разбирает отдельную функцию по пяти аналитическим слоям через утилиту tldr. Помогает при отладке и рефакторинге запутанного кода. CX Codex +1 481установок migrate Ведёт миграцию от исследования цели до проверки изменений. Пригодится при обновлении фреймворка, языка, базы данных или инфраструктуры. CX Codex +1 481установок

Похожие

logfire-ui pydantic Открывает экраны Logfire, трейсы и живой просмотр в браузере без предварительных запросов к телеметрии. CX Codex +1 1 600установок otel-semantic-conventions dash0 Помогает выбирать и проверять атрибуты телеметрии по спецификации OpenTelemetry Semantic Conventions. Пригодится, когда нужно назвать атрибут правильно, а не выдумывать своё. CX Codex +1 700установок caveman-compress JuliusBrussee Сжимает CLAUDE.md, списки задач и другие текстовые файлы в краткий формат, сохраняя читаемую резервную копию. CX Codex +1 411 500установок logfire-evals pydantic Прогоняет офлайн-оценки Python и Node.js, разбирает отчёты в Logfire и перенаправляет существующие наборы Braintrust. CX Codex +1 554установок analyze официальный anthropics Скилл разбирает аналитические вопросы, выгружает цифры через MCP-сервер хранилища или из CSV и готовит сводки от одной метрики до отчёта для стейкхолдеров. CX Codex +1 5 700установок analyze-feature-requests phuryn Скилл разбирает запросы на функции, группирует их по темам и ранжирует по влиянию, усилиям, рискам и связи с целями продукта. CX Codex +1 2 800установок

Рядом в теме «Настройка агента: память, контекст, субагенты»

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →

Вопросы о 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

Смотрите также

Спонсоры проекта

Компании, которые помогают держать аналитику открытой