braintrust-tracing

braintrust-tracing is a skill for Claude Code from vibeeval/vibecosystem. It costs 20 tokens per session (3,160 once invoked), scanned B, a copy of braintrust-tracing, MIT.

A guide for recording Claude Code sessions in Braintrust, a system for collecting and inspecting traces of software-agent activity. It includes the relationships between parent sessions and sub-agents.

In plain words
What is it for?
Use it to set up tracing hooks, connect sub-agent activity to its parent session, and inspect tool calls or debugging information.
Why use it?
It makes agent actions easier to investigate when a session fails or behaves unexpectedly.

Skill for Claude Code

Written for Claude Code: user-invocable in frontmatter. Also seen: reads .claude/ paths; mentions subagents; mentions Claude Code.

Good fit Use it to set up tracing hooks, connect sub-agent activity to its parent session, and inspect tool calls or debugging information.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/vibeeval/vibecosystem/braintrust-tracing
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add vibeeval/vibecosystem --skill braintrust-tracing
Clone the repo
git clone --depth 1 https://github.com/vibeeval/vibecosystem

Made for: Claude Code.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for braintrust-tracing

README.md
[![agentmods](https://agentmods.dev/badge/skills/vibeeval/vibecosystem/braintrust-tracing/github.svg)](https://agentmods.dev/skills/vibeeval/vibecosystem/braintrust-tracing)
Your own site
<a href="https://agentmods.dev/skills/vibeeval/vibecosystem/braintrust-tracing"><img src="https://agentmods.dev/badge/skills/vibeeval/vibecosystem/braintrust-tracing/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for braintrust-tracing

Your own site · 80×15
<a href="https://agentmods.dev/skills/vibeeval/vibecosystem/braintrust-tracing"><img src="https://agentmods.dev/badge/skills/vibeeval/vibecosystem/braintrust-tracing.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 20 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 3,160 The whole file, excluding the scripts and references it only reads on demand.
Security scan B 1 finding. A grade says what 26 rules found in the file — not that it is safe.
Origin 100% copy Near-identical to another mod in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00020 $0.03160
Opus 5 $0.00010 $0.01580
Sonnet 5 $0.00004 $0.00632
Haiku 4.5 $0.00002 $0.00316

Measured 5d ago against content hash d5a8155d9977, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-09, from the pricing page.

Security

Grade B, and why

braintrust-tracing scanned grade B with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 5d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Reads agent configuration directoriesmediumAgent snooping

.claude/, .codex/, .gemini/ hold keys, settings and other credentials a mod has no legitimate need for.

tail -f ~/.claude/state/braintrust_hook.log
Origin

This is a copy

100% identical to braintrust-tracing — 734 lines differ, which has more behind it and is treated as the original. This page carries a canonical link to it rather than competing with it.

skills/braintrust-tracing/SKILL.md · 368 lines

How it starts

The opening of the file, as written. The whole thing — 368 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Braintrust Tracing for Claude Code

Comprehensive guide to tracing Claude Code sessions in Braintrust, including sub-agent correlation.

Architecture Overview

                         PARENT SESSION
                    +---------------------+
                    |  SessionStart       |
                    |  (creates root)     |
                    +----------+----------+
                               |
                    +----------v----------+
                    |  UserPromptSubmit   |
                    |  (creates Turn)     |
                    +----------+----------+
                               |
          +--------------------+--------------------+
          |                    |                    |
+---------v--------+  +--------v--------+  +--------v--------+
| PostToolUse      |  | PostToolUse     |  | PreToolUse      |
| (Read span)      |  | (Edit span)     |  | (Task - inject) |
+------------------+  +-----------------+  +--------+--------+
                                                    |
                                         +----------v----------+
                                         |   SUB-AGENT         |
                                         |   SessionStart      |
                                         |   (NEW root_span_id)|
                                         +----------+----------+
                                                    |
                                         +----------v----------+
                                         |   SubagentStop      |
                                         |   (has session_id)  |
                                         +---------------------+

Hook Event Flow

Hook Trigger Creates Key Fields
SessionStart Session begins Root span session_id, root_span_id
UserPromptSubmit User sends prompt Turn span prompt, turn_number
PreToolUse Before tool runs (modifies Task prompts) tool_input.prompt
PostToolUse After tool runs Tool span tool_name, input, output
Stop Turn completes LLM spans model, tokens, tool_calls
SubagentStop Sub-agent finishes (no span) session_id of sub-agent
SessionEnd Session ends (finalizes root) turn_count, tool_count

Read the full file on GitHub · 368 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 5d ago First seen · 368 lines · 20 tokens per session scan B d5a8155d9977

Subscribe to this mod's changes

braintrust-tracing is a skill published in the GitHub repository vibeeval/vibecosystem (529 stars, last pushed 1mo ago), licensed MIT. It adds 20 tokens to every session and 3,160 once invoked, about $0.0001 per session on Opus 5. A static security scan graded it B with 1 finding (reads agent configuration directories). It is 100% identical to braintrust-tracing, differing in 734 lines, and is treated as a copy.

Related

Other skills, from other repositories

browser-edge-cases

SOP for debugging browser automation failures on complex websites. Use when browser tools fail on specific sites like LinkedIn, Twitter/X, SPAs, or sites with Shadow DOM.

aden-hive/hive · 40 tokens

review

Review the changes since a fixed point (commit, branch, tag, or merge-base) along two axes — Standards (does the code follow this repo's documented coding standards?) and Spec (does the code match what the originating issue/PRD asked for?). Runs both reviews in parallel sub-agents and reports them side by side. Use…

stevesolun/ctx · 95 tokens

agents-md-protocol

Create or review an AGENTS.md file so coding agents get stable repo-local instructions: environment setup, testing, style, security boundaries, PR policy, and handoff rules. Use when a repo lacks durable agent guidance or when a custom harness needs a predictable context file.

stevesolun/ctx · 59 tokens

impact-report-writer

Nonprofit/NGO impact report generation with data visualization suggestions, outcome metrics, narrative structure, and program data presentation. Use when writing impact reports, annual reports, or program evaluation summaries.

travisjneuman/.claude · 43 tokens

investment-memo-generator

Investment memo creation combining financial analysis, document generation, and structured templates. Use when creating investment memos, pitch decks, deal summaries, or investment committee materials.

travisjneuman/.claude · 37 tokens

git-workflow

Guided git workflows: prepare PRs, clean up branches, resolve merge conflicts, handle monorepo tags, squash-and-merge patterns. Use when asked to prepare a PR, clean branches, resolve conflicts, or tag a release.

jezweb/claude-skills · 52 tokens