Skip to content

Isurwars/Correlation / .agents/skills/packaging

packaging

Verified

Guide creation of distributable Linux packages (AppImage, DEB, RPM) and release artifacts for the Correlation desktop application. Use when packaging or preparing releases.

Release Packaging & Distribution

This skill automates the creation of distributable release artifacts for the Correlation application on Linux platforms.

1. Pre-Packaging Checklist

Before creating a release package:

  1. Version Bump: Ensure CMakeLists.txt contains the correct version: project(Correlation VERSION x.y.z).
  2. Release Build: Compile with optimizations and stripped debug symbols:
    cmake -B build -S . -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=/usr
    cmake --build build -j$(nproc)
    
  3. Test Verification: All test targets must pass:
    cmake --build build --target correlation_unit_tests correlation_functional_tests correlation_gui_tests -j$(nproc)
    ./build/tests/correlation_unit_tests
    ./build/tests/correlation_functional_tests
    ./build/tests/correlation_gui_tests
    

2. AppImage Creation

AppImage is the preferred format for portable Linux distribution.

Steps

  1. Install linuxdeploy:

    wget -q https://github.com/linuxdeploy/linuxdeploy/releases/download/continuous/linuxdeploy-x86_64.AppImage
    chmod +x linuxdeploy-x86_64.AppImage
    
  2. Install to AppDir:

    DESTDIR=AppDir cmake --install build
    
  3. Create Desktop Entry:

    [Desktop Entry]
    Name=Correlation
    Exec=correlation
    Icon=correlation
    Type=Application
    Categories=Science;Physics;Education;
    Comment=Liquid and Amorphous Solid Structural Analysis
    
  4. Bundle with linuxdeploy:

    ./linuxdeploy-x86_64.AppImage \
      --appdir AppDir \
      --desktop-file AppDir/usr/share/applications/correlation.desktop \
      --icon-file AppDir/usr/share/icons/correlation.png \
      --output appimage
    

3. DEB Package Creation

For Debian/Ubuntu distributions.

Using CPack (CMake-Integrated)

Add to CMakeLists.txt:

set(CPACK_GENERATOR "DEB")
set(CPACK_DEBIAN_PACKAGE_MAINTAINER "Isaías Rodríguez <isurwars@gmail.com>")
set(CPACK_DEBIAN_PACKAGE_DEPENDS "libc6 (>= 2.31), libstdc++6 (>= 11)")
set(CPACK_DEBIAN_PACKAGE_SECTION "science")
set(CPACK_DEBIAN_PACKAGE_DESCRIPTION "Structural analysis tool for liquids and amorphous solids")
include(CPack)

Build the package:

cd build && cpack -G DEB

4. RPM Package Creation

For Fedora/RHEL/CentOS distributions.

Using CPack

set(CPACK_GENERATOR "RPM")
set(CPACK_RPM_PACKAGE_LICENSE "AGPL-3.0-only")
set(CPACK_RPM_PACKAGE_GROUP "Applications/Science")
set(CPACK_RPM_PACKAGE_REQUIRES "glibc >= 2.31, libstdc++ >= 11")
include(CPack)

Build the package:

cd build && cpack -G RPM

5. Release Artifact Naming Convention

correlation-<version>-<arch>.<format>

Examples:

  • correlation-2.1.0-x86_64.AppImage
  • correlation_2.1.0_amd64.deb
  • correlation-2.1.0-1.x86_64.rpm

6. Post-Packaging Verification

  1. AppImage: Run on a clean system or container to verify all shared libraries are bundled.
  2. DEB: Install with sudo dpkg -i <package>.deb and verify with which correlation.
  3. RPM: Install with sudo rpm -i <package>.rpm and verify execution.
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 196kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 193kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 193kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 193kUpdated Claude CodeCodexVerifiedInstall