SKILL.md
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
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