cuda-agent-team

Coordinate parallel CUDA kernel optimization across multiple GPU-pinned worker agents.

3|Updated May 14, 2026
One-click install
npx skills add https://github.com/Romaosir/IF_Romao_kernel_optimize --skill cuda-agent-team
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: cuda-agent-team
Source: https://github.com/Romaosir/IF_Romao_kernel_optimize/tree/main/skills/b200_skill/cuda-agent-team
Command: npx skills add https://github.com/Romaosir/IF_Romao_kernel_optimize --skill cuda-agent-team

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

It solves the slow, plateauing progress of single-agent CUDA kernel optimization by running multiple independent optimization directions concurrently, then coordinating safe synchronization and merges to find better kernels faster.

Core Features & Use Cases

  • Parallel multi-agent optimization: Orchestrates two or more worker agents that each run the single-agent optimization loop in isolated working directories.
  • GPU-pinned, contention-safe execution: Assigns and pins each worker to its own GPU (via CUDA_VISIBLE_DEVICES) to keep speedup measurements comparable.
  • Round-based orchestration, sync, and merge: Tracks per-worker perf logs, decides when to adopt a winning baseline, and merges compatible wins via a defined merge protocol with correctness checks.
  • Use Case: If your kernel tuning has flattened for multiple iterations, you can split the effort into orthogonal hypotheses (e.g., memory restructuring vs. compute restructuring) and explore them in parallel across GPUs.

Quick Start

Ask the system to run the CUDA agent team for parallel kernel optimization when you have at least two GPUs available and want two distinct optimization directions explored concurrently.

Frequently Asked Questions about cuda-agent-team

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

FAQPage Schema
How do I speed up CUDA kernel tuning when single-agent optimization plateaus?

To speed up CUDA kernel tuning when single-agent optimization plateaus, run a parallel multi-agent approach that assigns distinct optimization directions to multiple worker agents exploring concurrently. This coordinates concurrent exploration across multiple GPUs to find better kernels faster.

How does parallel GPU pinning work for concurrent kernel optimization?

Parallel GPU pinning works by assigning each worker agent to its own isolated GPU via CUDA_VISIBLE_DEVICES, ensuring contention-safe execution. This keeps speedup measurements comparable while each agent runs an isolated experiment loop for concurrent kernel optimization.

Do I need multiple GPUs to run parallel CUDA kernel optimization?

Yes, you need at least two GPUs to run parallel CUDA kernel optimization. The orchestration requires per-agent working directory isolation and GPU assignment via CUDA_VISIBLE_DEVICES to ensure isolated, contention-safe execution for comparable speedup measurements.

What is the merge protocol for combining CUDA kernel optimizations from multiple agents?

The merge protocol for combining CUDA kernel optimizations tracks per-worker perf logs to decide when to adopt a winning baseline. It merges compatible wins through defined synchronization rounds with mandatory correctness checks and speedup validation for any merged kernel.

When should I split CUDA kernel tuning into orthogonal hypotheses across multiple GPUs?

You should split CUDA kernel tuning into orthogonal hypotheses across multiple GPUs when your tuning progress has flattened for multiple iterations. This allows you to explore distinct directions like memory restructuring versus compute restructuring concurrently to overcome single-agent plateaus.