Skip to content
OpenAgentSkill
Browsing is open · Catalog captured 2026-11-21 · Automatic updates and account services are paused.
Development

phoronix-test-suite

Install, run, parse, and optimize benchmarks from the Phoronix Test Suite (PTS). Use this skill whenever the user mentions "phoronix", "pts/", or "phoronix-test-suite", or asks to run, measure, improve, or optimize a PTS test — e.g., "run pts/mt-dgemm", "optimize pts/compress-zstd", "what score does pts/x265 get". Trigger immediately on any `pts/<testname>` reference, even if the user doesn't explicitly say "phoronix". Also trigger when the user asks to find or edit the source code of a PTS test.

intel · Static checks on file

Installation

Read the source and dependencies before running a command. Copying does not install or execute anything.

npx skills add intel/skills --skill phoronix-test-suite

About this skill


name: phoronix-test-suite description: Install, run, parse, and optimize benchmarks from the Phoronix Test Suite (PTS). Use this skill whenever the user mentions "phoronix", "pts/", or "phoronix-test-suite", or asks to run, measure, improve, or optimize a PTS test — e.g., "run pts/mt-dgemm", "optimize pts/compress-zstd", "what score does pts/x265 get". Trigger immediately on any pts/<testname> reference, even if the user doesn't explicitly say "phoronix". Also trigger when the user asks to find or edit the source code of a PTS test.

Phoronix Test Suite skill

End-to-end support for running and optimizing benchmarks with the Phoronix Test Suite CLI (phoronix-test-suite). PTS is used as shorthand throughout.

This skill is organized into two parts:

  • Part 1: flows — end-to-end workflows (running, optimizing)
  • Part 2: primitives — focused building blocks that flows compose

Part 1: flows

Flow A: running a test

Use when the user wants to run or benchmark a PTS test.

  1. Resolve the test version — if not specified, run Refresh test list and then Resolve test version
  2. Install — use Install a test
  3. Run — use Run a test
  4. Parse output — use Parse test output
  5. Save and report — save to the results store and report to the user:
    • State the test name, version, score, and unit
    • If a prior result for this test exists in the store, report the delta using Evaluate test scores

Flow B: optimizing a test

Use when the user wants to improve the performance of a PTS test.

Step 1 — Establish a baseline Run Flow A and label the result "baseline" in the results store.

Step 2 — Analyze the code

  • Use Prepare source code for editing to locate the source.
  • Read the test's entry-point shell script in the install directory to find the compiled binary.
  • Invoke the linux-perf skill to profile the binary and identify hotspots.
  • Invoke the performance-patterns skill to identify SIMD, vectorization, and other recognized code-pattern opportunities in hot paths.
  • Check generated.json → honors_cflags: if "1", compiler flag changes (for example, -march=native, -O3, -mavx512f) are respected by the test runner and are worth trying.
  • Check pts-install.json in the install directory for the original compiler flags as a starting point.

Step 3 — Make improvements Apply optimizations such as SIMD rewrites, compiler-flag changes, algorithmic changes, or data-layout changes. Edit the source directly in the prepared source directory.

Step 4 — Rebuild and measure

Step 5 — Report using this template

## Optimization Report: pts/<test-name>-<version>

### Baseline
- Score: <value> <unit>

### Changes Made
1. <Change description>
2. <Change description>
...

### Result
- Score: <value> <unit>
- Delta: <+/- value> (<+/- percentage>%)
- Verdict: **Improved** / **Regressed** / **No change**

### Pending Ideas
<Any ideas not yet tried, or "None">

Step 6 — Offer another round If "Pending Ideas" is non-empty, ask: "Would you like me to try another round of optimization?"


Part 2: primitives

Resolve PTS root directory

PTS stores data in different locations:

  • Running as root: /var/lib/phoronix-test-suite
  • Running as a regular user: ~/.phoronix-test-suite

Check which path exists. This is $ROOT throughout the rest of this skill.


Refresh test list

Run this before resolving versions to ensure the local test-profile cache is up to date with OpenBenchmarking.org. This downloads the latest test metadata and may reveal newer versions than what is locally cached.

phoronix-test-suite list-available-tests

Run this whenever:

  • The user asks for the latest version and you have not refreshed yet in this session
  • A test is not found in the local test-profiles directory
  • The user suspects a newer version exists

Resolve test version

When no version is specified, find the latest version available:

  1. Refresh first — run Refresh test list to pull the latest profiles from OpenBenchmarking.org
  2. Check the local cache — find the highest version in the test-profiles directory:
ls $ROOT/test-profiles/pts/ | grep "^<test-name>-" | sort -V | tail -1

Use the version suffix from the resulting directory name (for example, mt-dgemm-1.2.0 → version 1.2.0).


Install a test

Check whether it is already installed — skip the install if this path exists:

$ROOT/installed-tests/pts/<test-name>-<version>/<test-name>

If it is not installed:

phoronix-test-suite batch-install <test-name>-<version>

Run a test

Ensure the test is installed first. Running a test can take a long time — 10 minutes is common.

Auto-detect FORCE_TIMES_TO_RUN based on run_time_avg from generated.json:

  • If run_time_avg < 10 seconds → set FORCE_TIMES_TO_RUN=5
  • Otherwise → set FORCE_TIMES_TO_RUN=1
export FORCE_TIMES_TO_RUN=<value>
phoronix-test-suite batch-run <test-name>-<version>

Parse test output

PTS run output ends with a summary block. Example:

ACES DGEMM 1.0:
    pts/mt-dgemm-1.2.0
    Test 1 of 1
    ...
        Started Run 1 @ 16:00:50

    Sustained Floating-Point Rate:
        2.361582

    Average: 2.361582 GFLOP/s
    Samples: 1

Extract:

  • Score: the numeric value on the Average: line
  • Unit: the unit string on the same line (for example, GFLOP/s)

Evaluate test scores

Read hib from

Read the complete source ↗