diff --git a/config/scripts/build-identity/build-source-commit.mjs b/config/scripts/build-identity/build-source-commit.mjs
index 450958a..f739ce3 100644
--- a/config/scripts/build-identity/build-source-commit.mjs
+++ b/config/scripts/build-identity/build-source-commit.mjs
@@ -2,6 +2,13 @@ import { execFileSync } from 'node:child_process'
 
 // Pin official skill installs to the full build commit so installed and bundled skills agree on every channel.
 export function resolveBuildSourceCommit() {
+  // A build system compiling from a source archive (no git checkout) can pin the
+  // source ref (a tag or branch) explicitly via ORCA_BUILD_COMMIT; prefer it over
+  // the local HEAD so skill installs clone a ref that exists on the remote.
+  const pinned = (process.env.ORCA_BUILD_COMMIT || '').trim()
+  if (pinned) {
+    return pinned
+  }
   let commit = ''
   try {
     commit = execFileSync('git', ['rev-parse', 'HEAD'], { encoding: 'utf8' }).trim()
