Clawbox release packaging
Skill CommonstackAI/ClawBox/.agents/skills/clawbox-release-packaging
ClawBox provides a guided setup experience and unified dashboard for OpenClaw-powered agents.
npx -y skills add CommonstackAI/ClawBox --skill clawbox-release-packagingAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 22 stars22 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
What its author says it does
Copied from the file, not written here
Use when changing ClawBox Tauri packaging, sidecar bootstrapping, version synchronization, Bun backend compilation, or release-related scripts and configuration. This includes the UTC date-based version generator, Tauri and Cargo version sync, Windows installer signing helpers, and GitHub release workflow guards. Do not use for actually cutting and pushing a release tag; use the release publish skill for that.
SKILL.md
3.8 KB, as published. Nobody here has run it
ClawBox Release Packaging
Use this skill when the task involves ClawBox versioning, Tauri configuration, backend binary packaging, sidecar lifecycle, or release build scripts.
Read first
package.jsondocs/releasing.md.github/release-notes-template.mddocs/releases/scripts/collect-release-assets.mjsscripts/release-version.mjsscripts/sync-version.mjsscripts/sign-win-installer.mjsscripts/build-backend.mjs.github/workflows/release.ymlsrc-tauri/tauri.conf.jsonsrc-tauri/Cargo.tomlsrc-tauri/src/lib.rsinternal/onboard/if the task also affects runtime bootstrap or environment setup
Workflow
- Identify which layer is changing: UTC version generation, version synchronization, Bun backend compile output, Tauri shell, release workflow guard, release-notes lookup, release-asset filtering, or installer/signing script.
- Preserve
package.jsonas the single source of truth for the app version. Any version automation must keeppackage-lock.json,src-tauri/tauri.conf.json, andsrc-tauri/Cargo.tomlaligned. - Keep the UTC date-based version format semver-safe. The current release flow uses
YYYY.M.D-N, withgit fetch --tagsplus localvYYYY.M.D-Ntags determining the next sequence. - Keep sidecar naming and resource lookup behavior aligned with
scripts/build-backend.mjsandsrc-tauri/src/lib.rs. - Keep Windows installer signing dynamic.
tauri:build-win:sign-installershould resolveClawBox_<version>_x64-setup.exefrompackage.json, not from a hard-coded filename. - Keep release publication scoped to user-facing assets only. The workflow should publish final
.dmg,.exe, and the combinedCHECKSUMS.txt, not the entire Tauri bundle tree. - Keep release notes lookup aligned with the documented flow. Hand-written notes live at
docs/releases/<tag>.md, with GitHub-generated notes as the fallback when the file is absent. - If the change touches release publication behavior rather than packaging/configuration, hand off to
clawbox-release-publishinstead of extending this skill. - If the change touches Windows signing or platform-specific installers, note any credentials or OS environments you could not validate.
Verification
- Run
node scripts/release-version.mjs --dry-runornpm run release:version -- --dry-runwhen changing release-version logic. - Run
npm run sync-version. - Run
npm run build:backend. - If Rust is available, run
cargo check --manifest-path src-tauri/Cargo.toml. - If the change touches the release workflow, confirm that the workflow still rejects a tag/version mismatch, still publishes only final user assets, and still prefers
docs/releases/<tag>.mdover auto-generated notes when that file exists.
Guardrails
- Do not guess bundle resource paths or binary names.
- Do not hand-edit version values when changing the automated version flow; keep
npm version ... --no-git-tag-versionas the writer forpackage.jsonandpackage-lock.json. - Do not reintroduce a hard-coded Windows installer filename into
package.jsonscripts. - Do not blur the boundary between "release packaging/config" and "actual release execution"; use
clawbox-release-publishwhen the task is to cut, commit, tag, or push a release. - Keep cross-platform branches explicit instead of merging them into a single simplified path.
- Mention any skipped platform validation in the final response.