brave-core-tools

Shared development tools, best practices, and Claude Code skills for brave-core development.

Setup

Clone into your brave-browser directory (as a sibling of src/):

cd brave-browser
git clone https://github.com/brave-experiments/brave-core-tools.git
cd brave-core-tools
./setup.sh

This will:

1. Symlink skills to src/brave/.claude/skills/
2. Symlink best practices to src/brave/.claude/rules/best-practices

What's Included

Skills

Skill	Description
/add-best-practice	Add a new best practice entry to the docs
/fix-bp-docs	Audit and fix stale references, duplicates, and formatting in best practices docs
/check-best-practices	Audit branch changes against best practices
/check-milestones	Check/fix milestones on PRs and issues
/check-upstream-flake	Check LUCI Analysis for upstream test flakiness
/clean-branches	Delete local branches whose PRs are merged
/commit	Create atomic git commits
/force-push-downstream	Force-push branch + all downstream branches
/impl-review	Implement PR review feedback
/make-ci-green	Re-run failed CI jobs (requires env vars, see below)
/pr	Create a pull request for the current branch
/preflight	Run all preflight checks (format, build, test)
/rebase-downstream	Rebase a tree of dependent branches
/review	Code review (PR or local changes)
/top-crashers	Query Backtrace for top crash data (requires env vars, see below)
/uplift	Cherry-pick fixes to beta/release branches

Required Environment Variables

Some skills require API keys or environment variables to be set (e.g., in your .envrc):

/top-crashers:

Variable	Description
BACKTRACE_API_KEY	Backtrace API token with query:post capability
BACKTRACE_PROJECT	Backtrace project name (or pass --project argument)

/make-ci-green:

Variable	Description
JENKINS_BASE_URL	Jenkins CI server base URL
JENKINS_USER	Jenkins username
JENKINS_TOKEN	Jenkins API token (from $JENKINS_BASE_URL/me/configure)

Best Practices

16 best-practice documents covering coding standards, testing, architecture, build system, Android, iOS, frontend, and more. See BEST-PRACTICES.md for the full index.

Scripts

• scripts/check-upstream-flake.py — Check Chromium LUCI Analysis for upstream test flakiness
• scripts/top-crashers.py — Query Backtrace crash reporting
• scripts/manage-bp-ids.py — Manage stable IDs in best-practice documents

Updating

cd brave-core-tools
git pull origin master

Symlinks are stable across updates — no need to re-run setup.