peteonrails

package-release

@peteonrails/package-release
peteonrails
214
14 forks
Updated 1/18/2026
View on GitHub

Package voxtype for release. Creates deb and rpm packages from binaries. Use when building distribution packages.

Installation

$skills install @peteonrails/package-release
Claude Code
Cursor
Copilot
Codex
Antigravity

Details

Path.claude/skills/package-release/SKILL.md
Branchmain
Scoped Name@peteonrails/package-release

Usage

After installing, this skill will be available to your AI coding assistant.

Verify installation:

skills list

Skill Instructions


name: package-release description: Package voxtype for release. Creates deb and rpm packages from binaries. Use when building distribution packages. user-invocable: true allowed-tools:

  • Bash
  • Read
  • Glob

Package Release

Build distribution packages (deb, rpm) for voxtype releases.

Prerequisites

  • fpm - Install with gem install fpm
  • rpmbuild - Install with sudo dnf install rpm-build or sudo pacman -S rpm-tools
  • Pre-built binaries in releases/${VERSION}/

Quick Package

If binaries already exist:

./scripts/package.sh --skip-build ${VERSION}

Full Build + Package

Build binaries and create packages:

./scripts/package.sh ${VERSION}

Options

FlagDescription
--skip-buildUse existing binaries, don't rebuild
--deb-onlyBuild only Debian package
--rpm-onlyBuild only RPM package
--no-validateSkip package validation
--release NSet package release number (default: 1)
--arch ARCHTarget architecture: x86_64 or aarch64

Output

Packages are created in releases/${VERSION}/:

  • voxtype_${VERSION}-1_amd64.deb
  • voxtype-${VERSION}-1.x86_64.rpm

Validation

The script automatically:

  1. Validates binaries for CPU instruction contamination
  2. Checks deb package structure for duplicate fields
  3. Verifies required control file fields

Workflow

  1. Build binaries (Docker for AVX2/Vulkan, local for AVX-512)
  2. Verify binary versions match expected version
  3. Run ./scripts/package.sh --skip-build ${VERSION}
  4. Test package installation in a VM or container

Common Issues

Binary not found:

Error: Binary not found: releases/0.4.14/voxtype-0.4.14-linux-x86_64-avx2

Build binaries first or check the version number.

fpm not found:

gem install fpm

Validation failed: Check the specific error. Usually means Docker cache is stale.