Validate runtime loading
Testing & QualityValidate runtime loading is an Agent Skill for testing & quality 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 runtime selection, RuntimeOptions, NativeLibraryLoader, runtime package imports, or examples that force runtime order.
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/validate-runtime-loading/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/validate-runtime-loading, 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.
Validate runtime loading
Use this skill when a task changes runtime discovery or selection, including RuntimeOptions, RuntimeLibrary, NativeLibraryLoader, runtime targets, dependency checker behavior, or examples that set RuntimeOptions.RuntimeLibraryOrder.
Runtime surfaces to keep in sync
Whisper.net/LibraryLoader/RuntimeLibrary.csWhisper.net/LibraryLoader/RuntimeOptions.csWhisper.net/LibraryLoader/NativeLibraryLoader.csWhisper.net/LibraryLoader/CudaHelper.csfor CUDA-specific probingtools/WhisperNetDependencyChecker/Program.csexamples/MultiRuntime/Program.cs- README runtime package and runtime-order documentation
runtimes/*.nuspecandruntimes/*/*.targetswhen package layout changes
Current runtime order
The default order is:
Cuda, Cuda12, Vulkan, CoreML, OpenVino, Cpu, CpuNoAvx
Preserve this order unless the task intentionally changes runtime preference behavior. If the order changes, update XML docs and README text together.
Validation
With native artifacts present under runtimes/, run the dependency checker for each affected 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
Then run the managed test suite:
dotnet test .\Whisper.net.slnx --logger "trx"
Only use the preview native libs shortcut when the change is managed-only and does not alter runtime package layout or native outputs.