Change native runtimes
DevelopmentChange native runtimes is an Agent Skill for development published in the sandrohanea/whisper.net repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Use when changing whisper.cpp, native build scripts, runtime artifact layout, or native runtime package contents.
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/sandrohanea/whisper.net/blob/HEAD/.github/skills/change-native-runtimes/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/change-native-runtimes, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
Change native runtimes
Use this skill when a task changes whisper.cpp, native build workflows, windows-scripts.ps1, Makefile, native dependency packaging, or files under runtimes/ that describe native runtime packages.
Do not use preview native libs
Do not validate these changes with downloaded preview native libs. Preview native libs are only a shortcut for managed-only validation. Native runtime changes must build or consume artifacts produced from the changed native inputs.
Key places to inspect
.github/workflows/*native-build.ymlfor the CI build matrix..github/workflows/build-all.ymland.github/workflows/upload-build-artifacts.ymlfor artifact aggregation and preview release publishing.windows-scripts.ps1andMakefilefor local native build entry points.runtimes/*.nuspecandruntimes/*/*.targetsfor package contents and MSBuild imports.tools/WhisperNetDependencyChecker/Program.csfor runtime load validation.
Windows local build entry points
From the repository root, dot-source the script and build only the relevant runtime when possible:
. .\windows-scripts.ps1
BuildWindows "Release"
BuildWindowsIntel "Release"
BuildWindowsArm "Release"
BuildWindowsAll "Release"
Use the specific function that matches the task. Do not rebuild every native runtime unless the change affects shared native build logic.
Dependency checker validation
After placing built artifacts under runtimes/, validate native loading for the changed runtime:
dotnet run --project .\tools\WhisperNetDependencyChecker\WhisperNetDependencyChecker.csproj
dotnet run --project .\tools\WhisperNetDependencyChecker\WhisperNetDependencyChecker.csproj -- CpuNoAvx
dotnet run --project .\tools\WhisperNetDependencyChecker\WhisperNetDependencyChecker.csproj -- Cuda
dotnet run --project .\tools\WhisperNetDependencyChecker\WhisperNetDependencyChecker.csproj -- Cuda12
dotnet run --project .\tools\WhisperNetDependencyChecker\WhisperNetDependencyChecker.csproj -- Vulkan
dotnet run --project .\tools\WhisperNetDependencyChecker\WhisperNetDependencyChecker.csproj -- CoreML
dotnet run --project .\tools\WhisperNetDependencyChecker\WhisperNetDependencyChecker.csproj -- OpenVino
Only run checks for runtimes relevant to the change and available on the current machine.
Package validation
When native package contents or targets change, also use the Validate runtime packages and releases skill before opening a PR.