Agent skill

Bisect Perf Regression

by ROCm in ROCm/FlyDSL

Find the exact commit that caused a GPU kernel performance regression using binary search (git bisect).

Custom licenceAuto-check: notesDevelopment

Install Bisect Perf Regression

skills CLI
$ npx skills add ROCm/FlyDSL --skill bisect-perf-regression -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install ROCm/FlyDSL bisect-perf-regression --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/ROCm/FlyDSL.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/bisect-perf-regression .claude/skills/bisect-perf-regression && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
bisect-perf-regression
GitHub stars
288
Token cost
~4k tokens
SKILL.md length
887 words
Files
1
Skills in repo
19
Repo updated
First seen
Licence
Custom licence

At a glance

Find the exact commit that caused a GPU kernel performance regression using binary search (git bisect).

  • Works in 6 steps: Validate Environment → Enumerate Commits → Establish Baselines → …
  • Tasks that involve Root cause analysis
  • SKILL.md covers Arguments, Prerequisites, Algorithm and Step 0: Validate Environment, plus 9 more sections
  • Calls git, pip and python3

What it does

Bisect Perf Regression is an agent skill from ROCm/FlyDSL. Find the exact commit that caused a GPU kernel performance regression using binary search (git bisect). Given a good commit (fast), a bad commit (slow, defaults to HEAD), and a benchmark command, automatically checks out commits, runs the benchmark, extracts the metric, and narrows down to the offending commit. Reports the regression commit with its diff and suggested root cause. Usage: /bisect-perf-regression <goodcommit [badcommit] -- <benchcmd

Its SKILL.md is about 4k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Development, covering Root cause analysis. It works with Git. The repository describes itself as: FlyDSL is the Python front‑end of the project: a Flexible Layout Python DSL for expressing tiling, partitioning, data movement, and kernel structure at a high level.

When your agent uses it

  • Tasks that involve Root cause analysis

Example prompts

  • “/bisect-perf-regression”

Requirements

  • Python 3
  • Pre-approved tools (allowed-tools): Bash, Read, Grep, Glob, Agent

Workflow steps

6 steps, taken from the step headings in SKILL.md.

  1. Validate Environment
  2. Enumerate Commits
  3. Establish Baselines
  4. Binary Search (Bisect)
  5. Report the Regression Commit
  6. Cleanup

What it can do on your machine

Read from SKILL.md and the folder at commit 1941889. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Bash
    • Read
    • Grep
    • Glob
    • Agent

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • git
    • pip
    • python3

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use git and pip, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Bisect Perf Regression loads about 4k tokens when it runs. Until then it costs about 120 tokens; SKILL.md has 887 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~120
When it runs · the whole SKILL.md, loaded when a task matches
~4k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Bash, Read, Grep, Glob, Agent

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 887 words (~3,973 tokens).

“Find the exact git commit that introduced a kernel performance regression using binary search.”

— opening of SKILL.md by ROCm, Custom licence
name
bisect-perf-regression
allowed-tools
Bash, Read, Grep, Glob, Agent

Read the full SKILL.md on GitHub

Files

Just SKILL.md in .claude/skills/bisect-perf-regression of ROCm/FlyDSL.

Open the folder on GitHubat commit 1941889

Compare with similar skills

Bisect Perf Regression next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Bisect Perf Regression compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Bisect Perf Regression this skillROCm/FlyDSL288—~4kAutomated safety check: NotesCustom licence
Code Design Rationale Investigatorcursor/plugins10k9 repos~2.6kAutomated safety check: PassNone
Debugging and Error Recoveryaddyosmani/agent-skills103k1 repos~2.6kAutomated safety check: PassMIT
Root Cause Tracingsandgardenhq/sgai1374 repos~1.4kAutomated safety check: PassCustom licence
Codexqa Rootcause Analyzeropenqa-cn/codexqa152—~2.6kAutomated safety check: PassApache-2.0
Investigate Issueanalogjs/analog3.2k—~2kAutomated safety check: PassMIT

Similar skills

  • Official

    Digs into why code is shaped the way it is by checking git history, pull requests and connected tools in parallel, then reporting a cited read on the tradeoffs.

    10k GitHub starsUsed in 9 repos~2.6k tokens
    DevelopmentAuto-check passed
  • Debugging and Error Recovery

    addyosmani/agent-skills

    Applies a stop-the-line rule and a step-by-step triage when tests fail, builds break or something stops working, aiming at the root cause instead of guesses.

    103k GitHub starsUsed in 1 repo~2.6k tokens
    DevelopmentAuto-check passed
  • Root Cause Tracing

    sandgardenhq/sgai

    A skill your agent uses when errors occur deep in execution and you need to trace back to find the original trigger - systematically traces bugs backward through call stack, adding instrumentation…

    137 GitHub starsUsed in 4 repos~1.4k tokens
    DevelopmentAuto-check passed
  • Diagnoses exception root causes from stack traces, logs, call-chain dumps, and debug output using the CodexQA CLI for structured repo analysis.

    152 GitHub stars~2.6k tokensUpdated 5 days ago
    DevelopmentAuto-check passed
  • Investigate Issue

    analogjs/analog

    Investigate a GitHub issue end to end — reproduce the reporter's repo or code snippet in an isolated sandbox outside the monorepo, trace the root cause in the source, and draft a reply back to the…

    3.2k GitHub stars~2k tokensUpdated today
    DevelopmentAuto-check passed
  • Debug

    gnomeria/usbtree

    Systematic root-cause debugging — reproduce, isolate, fix at the source, prove the fix.

    690 GitHub stars~715 tokensUpdated 1 mo ago
    DevelopmentAuto-check passed

More from ROCm/FlyDSL

All 19 skills in this repo
  • Llvm

    ROCm/FlyDSL

    Tune and analyse a FlyDSL kernel at the LLVM level: pick a compile hint, function attribute, or AMDGPU backend flag, then PROVE it reached codegen.

    288 GitHub stars~4.9k tokensUpdated today
    Auto-check: notes
  • Detect per-kernel GPU resource regressions (VGPR, SGPR, register spills, scratch, static LDS) by diffing the final ISA before and after a change, using its isaresourcetable.py helper.

    288 GitHub stars~2.7k tokensUpdated today
    Auto-check: notes
  • API Stability

    ROCm/FlyDSL

    Review a FlyDSL PR, commit, branch, kernel, or consuming module for API-stability compliance.

    288 GitHub stars~3.2k tokensUpdated today
    Auto-check: notes
  • Build Rocm Image

    ROCm/FlyDSL

    Connect to a remote host via SSH and build a Docker image with rocprofv3, aiter, and FlyDSL.

    288 GitHub stars~1.2k tokensUpdated today
    Auto-check: notes
  • Debug FlyDSL GPU kernels that produce NaN, inf, wrong results, or crash.

    288 GitHub stars~2.6k tokensUpdated today
    Auto-check: notes
  • Guided step-by-step wizard for producing a new FlyDSL GPU kernel from a requirement: classify the kernel type, pick a skeleton, fill in compute, add control flow / sync / LDS, then test on GPU.

    288 GitHub stars~4.6k tokensUpdated today
    Auto-check: notes

Works with

Categories

Questions about Bisect Perf Regression

What does Bisect Perf Regression do?

Find the exact commit that caused a GPU kernel performance regression using binary search (git bisect). Bisect Perf Regression is an agent skill from ROCm/FlyDSL. Find the exact commit that caused a GPU kernel performance regression using binary search (git bisect).

When should I use Bisect Perf Regression?

Bisect Perf Regression fits situations like: tasks that involve Root cause analysis.

How do I install Bisect Perf Regression in Claude Code?

Run `npx skills add ROCm/FlyDSL --skill bisect-perf-regression -a claude-code`. Or copy the skill folder (.claude/skills/bisect-perf-regression in ROCm/FlyDSL) into .claude/skills/bisect-perf-regression in your project. Claude Code loads it when a task matches its description.

How do I install Bisect Perf Regression in Codex?

Run `npx skills add ROCm/FlyDSL --skill bisect-perf-regression -a codex`. Or copy the skill folder (.claude/skills/bisect-perf-regression in ROCm/FlyDSL) into .agents/skills/bisect-perf-regression in your project. Codex loads it when a task matches its description.

Can I use Bisect Perf Regression in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add ROCm/FlyDSL --skill bisect-perf-regression -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/bisect-perf-regression, .gemini/skills/bisect-perf-regression, .github/skills/bisect-perf-regression and .opencode/skills/bisect-perf-regression in your project.

What does Bisect Perf Regression need to run?

Going by SKILL.md and its folder, Bisect Perf Regression needs the command-line tools its instructions call (git, pip and python3). Our summary lists: Python 3. Its frontmatter pre-approves these tools: Bash, Read, Grep, Glob, Agent.

Does Bisect Perf Regression access the network?

SKILL.md contains no URLs. Its commands use git and pip, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Bisect Perf Regression safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Bisect Perf Regression use?

Bisect Perf Regression has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Bisect Perf Regression use?

About 4k tokens (SKILL.md is roughly 16k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Bisect Perf Regression?

Skills that share tags, products or a category with Bisect Perf Regression: Code Design Rationale Investigator (cursor/plugins, 10k stars), Debugging and Error Recovery (addyosmani/agent-skills, 103k stars), Root Cause Tracing (sandgardenhq/sgai, 137 stars) and Codexqa Rootcause Analyzer (openqa-cn/codexqa, 152 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Bisect Perf Regression?

ROCm (a GitHub organization) maintains it in ROCm/FlyDSL, which has 288 GitHub stars. The repository holds 19 skills in this directory. The repository was last updated on October 8, 2026.

Source: ROCm/FlyDSL on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.