source-oneapi

name	source-oneapi
description	Source the Intel oneAPI environment before running workloads that depend on oneAPI, SYCL, DPC++, or Level Zero. Use this skill when the user needs to set up oneAPI, source setvars.sh, configure the Intel compiler environment, or when icpx/sycl-ls are not found in PATH.
license	MIT
metadata	{"oneAPI":"Intel oneAPI","SYCL":"Intel DPC++","XPU":"Intel GPU"}

Source Intel oneAPI Environment

You MUST source oneAPI components individually. Do NOT use setvars.sh.

source <oneapi_root>/compiler/latest/env/vars.sh
source <oneapi_root>/pti/latest/env/vars.sh
source <oneapi_root>/umf/latest/env/vars.sh
source <oneapi_root>/ccl/latest/env/vars.sh
source <oneapi_root>/mpi/latest/env/vars.sh

Instructions

Step 1: Check if already sourced

which icpx 2>/dev/null && echo "${CMPLR_ROOT:-}"

If CMPLR_ROOT is set and icpx is found, the environment is already initialized. Skip to Step 4.

Step 2: Find the oneAPI installation root

Check candidates in this order. Use the first one where compiler/latest/env/vars.sh exists:

1. $HOME/intel/oneapi
2. $HOME/oneapi
3. Other paths under $HOME:

   find "$HOME" -maxdepth 4 -type f -path "*/oneapi/compiler/latest/env/vars.sh" 2>/dev/null | sed 's|/compiler/latest/env/vars.sh||' | sort
   

4. /opt/intel/oneapi
5. Other paths under /opt:

   find /opt -maxdepth 4 -type f -path "*/oneapi/compiler/latest/env/vars.sh" 2>/dev/null | sed 's|/compiler/latest/env/vars.sh||' | sort
   

If no valid root is found, stop and ask the user for the path.

If multiple roots are found at the same priority level, ask the user to choose.

Do NOT fall through to /opt if a valid root exists under $HOME.

Step 3: Source components

source <oneapi_root>/compiler/latest/env/vars.sh
source <oneapi_root>/pti/latest/env/vars.sh
source <oneapi_root>/umf/latest/env/vars.sh
source <oneapi_root>/ccl/latest/env/vars.sh
source <oneapi_root>/mpi/latest/env/vars.sh

Skip any component whose env/vars.sh does not exist. Report skipped components to the user.

Step 4: Verify

which icpx && which sycl-ls && echo "${CMPLR_ROOT:-}"

If sycl-ls is not found, stop and report: "sycl-ls not found. Check whether the oneAPI DPC++/Compiler component is installed."

Step 5: Run workload

Run all subsequent commands in the same shell session. Environment variables do not persist across sessions.

If the workload targets a specific GPU, use the "intel-gpu-device-selection" skill to set ZE_AFFINITY_MASK before running.