Sprinkles: Guix Maintenance Skills for pi.dev

sprinkles is a collection of specialized skills for the pi.dev agent to automate the maintenance, creation, and auditing of GNU Guix packages.

Overview

These skills codify the "mental model" of a Guix maintainer, automating the tedious parts of package lifecycle management while enforcing strict adherence to Guix's purity and style conventions.

Included Skills

• version-bump: Fast and accurate updates of package versions and hashes.
• package-creation: A guided workflow for creating new package definitions, mirroring "sibling" packages for consistency.
• binary-audit: A forensic tool to detect hardcoded paths, impure shebangs, and binary dependencies.
• build-fixer: A surgical tool for diagnosing build failures and implementing modify-phases or patches.

Installation

Since sprinkles is a formal pi package, you can install it directly using the pi CLI:

pi install git:git.sr.ht/~whereiseveryone/sprinkles

Alternatively, you can try the skills without installing them permanently by using the --extension (or -e) flag:

pi -e git:git.sr.ht/~whereiseveryone/sprinkles

Usage

Once installed, you can trigger these skills by asking the agent to perform specific Guix maintenance tasks. Examples:

• Updating a version: "Update emacs-hel to 0.13.0" (Triggers version-bump)
• Adding a new package: "Package emacs-hel-leader similarly to emacs-hel" (Triggers package-creation)
• Auditing for purity: "Audit emacs-foo for binary purity" (Triggers binary-audit)
• Fixing a build error: "Fix the build for emacs-bar, it's complaining about a missing interpreter" (Triggers build-fixer)

License

This project is licensed under the GNU General Public License v3.0.