How do I install the Braintrust Analyze skill?

Run npx skillmds@latest add tomevault-io/braintrust-analyze in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

What does the Braintrust Analyze skill do?

Analyze Claude Code sessions via Braintrust Use when this capability is needed. It is listed under Coding & Dev Tools on SkillMD.

Is Braintrust Analyze safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Braintrust Analyze?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Braintrust Analyze free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Braintrust Analyze?

tomevault-io (@tomevault-io) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Braintrust Analyze by tomevault-io — Agent Skill

Name: Braintrust Analyze
Author: tomevault-io

File contents

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:

# 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

# 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

uv run python -m runtime.harness scripts/braintrust_analyze.py --detect-loops

Weekly Review

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)

Converted and distributed by TomeVault — claim your Tome and manage your conversions.

---name: braintrust-analyzedescription: Analyze Claude Code sessions via Braintrust Use when this capability is needed.---# Braintrust AnalysisAnalyze 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## CommandsRun from the project directory:```bash# Analyze last session - summary with tool/agent/skill breakdownuv run python -m runtime.harness scripts/braintrust_analyze.py --last-session# List recent sessionsuv 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 actionsuv run python -m runtime.harness scripts/braintrust_analyze.py --replay <session-id># Weekly summary - daily activity breakdownuv run python -m runtime.harness scripts/braintrust_analyze.py --weekly-summary# Token trends - usage over timeuv 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 DetectionFind 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```bashuv run python -m runtime.harness scripts/braintrust_analyze.py --detect-loops```### Weekly Review```bashuv 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)---> Converted and distributed by [TomeVault](https://tomevault.io/claim/parcadei) — claim your Tome and manage your conversions.

Frequently asked questions

Braintrust Analyze