opp-repl-speed-tests

Measure CPU instruction counts to detect performance regressions in opp_repl simulations.

Updated Apr 23, 2026
One-click install
npx skills add https://github.com/tabgab/opp_repl-skill --skill opp-repl-speed-tests
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: opp-repl-speed-tests
Source: https://github.com/tabgab/opp_repl-skill/tree/main/opp-repl-speed-tests
Command: npx skills add https://github.com/tabgab/opp_repl-skill --skill opp-repl-speed-tests

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Speed tests measure the CPU instruction count of a simulation and compare it to a baseline stored in speed_store. Instruction counts are more deterministic than wall time, enabling reliable regression detection in noisy CI environments.

Core Features & Use Cases

  • Measure CPU instruction counts via Linux perf counters.
  • Compare results against the baseline in speed_store to identify regressions.
  • Provide deterministic performance verification across builds and configurations in CI.

Quick Start

Seed the baseline with update_speed_test_results and then run the speed tests with run_speed_tests.

Frequently Asked Questions about opp-repl-speed-tests

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I detect performance regressions in noisy CI environments?

You can detect performance regressions in CI by measuring CPU instruction counts instead of wall time. Instruction counts provide deterministic performance verification across builds, overcoming the inconsistency of noisy environments.

How do I measure CPU instruction counts for simulation performance checks?

You measure CPU instruction counts using Linux perf counters. By tracking these counters during a simulation, you get a deterministic metric to compare against a stored baseline for reliable regression detection.

Why use CPU instruction counts instead of wall time for performance benchmarking?

CPU instruction counts are used instead of wall time because they offer higher determinism. Wall time fluctuates in noisy environments, while instruction counts reliably quantify performance regressions across different builds.

Do I need Linux perf support to run these speed tests?

Yes, you need Linux perf support to run these speed tests. The skill relies on Linux perf counters to measure the CPU instruction counts required for its deterministic performance regression detection.

How do I set up a baseline for simulation speed tests?

To set up a baseline for speed tests, you seed it using the update_speed_test_results interface. Once the baseline is stored in speed_store, you run subsequent tests with run_speed_tests to compare against it.

Can I verify performance across different build configurations in CI?

Yes, you can verify performance across different build configurations in CI. The skill compares CPU instruction counts against a stored baseline, providing deterministic regression checks across various builds.