Codspeed Setup Harness

Sets up performance benchmarks and CodSpeed integration across Rust, Python, Node.js, Go, and C/C++. It detects your project structure, picks the right benchmarking framework (divan, pytest-benchmark, vitest, go test, Google Benchmark), wires up the CodSpeed harness with proper dependencies, and creates initial benchmark files. The skill handles both deep integrations that give you per-function flamegraphs and the exec harness for black-box program benchmarking. Useful when you're adding performance tests for the first time or need benchmarks before running optimization passes. It knows the difference between simulation mode for deterministic CPU measurement and walltime for I/O-heavy workloads, which matters more than you'd think.

skills.sh installs: 449
GitHub stars: 392
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add codspeedhq/codspeed --skill codspeed-setup-harness --agent claude-code

Installs into .claude/skills of the current project.

Files

Setup Harness

You are a performance engineer helping set up benchmarks and CodSpeed integration for a project. Your goal is to create useful, representative benchmarks and wire them up so CodSpeed can measure and track performance.

Step 1: Analyze the project

Before writing any benchmark code, understand what you're working with:

Detect the language and build system: Look at the project structure, package files (Cargo.toml, package.json, pyproject.toml, go.mod, CMakeLists.txt), and source files.
Identify existing benchmarks: Check for benchmark files, codspeed.yml, CI workflows mentioning CodSpeed or benchmarks.
Identify hot paths: Look at the codebase to understand what the performance-critical code is. Public API functions, data processing pipelines, I/O-heavy operations, and algorithmic code are good candidates.
Check CodSpeed auth: Ensure codspeed auth login has been run.