.claude/skills/install-ort/SKILL.md
Install ONNX Runtime for the ort crate in a sandboxed environment
npx skillsauth add acornprover/acorn .claude/skills/install-ortInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
The ort crate's build script (ort-sys) tries to download ONNX Runtime static libraries at build time. In sandboxed environments, this often fails with TLS certificate errors because the build script's HTTP client doesn't trust the proxy's certificates, even though curl works fine.
Build failures with messages like:
Failed to GET `https://parcel.pyke.io/v2/delivery/ortrs/packages/msort-binary/...`: Connection Failed: tls connection init failed: invalid peer certificate: UnknownIssuer
Check Cargo.toml for the pinned ort version:
grep 'ort' Cargo.toml
The ort-sys version and download URL are determined by the ort version. For ort = "=2.0.0-rc.9", the URL is:
https://parcel.pyke.io/v2/delivery/ortrs/packages/msort-binary/1.20.0/ortrs_static-v1.20.0-x86_64-unknown-linux-gnu.tgz
If you're unsure of the URL, check the build error output — the ort-sys build script prints the full URL it's trying to fetch.
mkdir -p /tmp/ort-lib
curl -sL https://parcel.pyke.io/v2/delivery/ortrs/packages/msort-binary/1.20.0/ortrs_static-v1.20.0-x86_64-unknown-linux-gnu.tgz -o /tmp/ort-lib/ort.tgz
cd /tmp/ort-lib && tar xzf ort.tgz
Verify the library was extracted:
ls /tmp/ort-lib/onnxruntime/lib/libonnxruntime.a
Prefix all cargo commands with ORT_LIB_LOCATION=/tmp/ort-lib/onnxruntime:
ORT_LIB_LOCATION=/tmp/ort-lib/onnxruntime cargo test --lib
ORT_LIB_LOCATION=/tmp/ort-lib/onnxruntime cargo build --profile release
ORT_LIB_LOCATION=/tmp/ort-lib/onnxruntime cargo check
This tells the ort-sys build script to use the pre-downloaded library instead of fetching it.
ORT_LIB_LOCATION=/tmp/ort-lib/onnxruntime cargo test --lib 2>&1 | tail -5
You should see test results instead of a build failure.
/tmp/ort-lib/ for the session. If the sandbox is reset, you'll need to re-download.tools
Use when asked to profile Acorn prover or verifier performance, investigate where time is spent, or generate a top-down runtime breakdown from `perf` or `samply`.
development
Use when a proof/module verifies in baseline mode but reproving under a prover-affecting feature flag fails. Add explicit proof detail based on the working baseline proof until `cargo run --features <feature> -- verify ...` succeeds.
tools
Profile the prover and generate a top-down performance summary
development
Use when asked to migrate to a feature flag or roll out a manifest-gated acornlib certificate/build-cache or proof-format change. This skill covers feature-flag migrations, including the state-machine workflow for verifier, proof, and cache migrations.