skills.rest
cameronraysmith
cameronraysmithCOMMUNITY
Explore all skills by this author →
Website𝕏@cameronraysmithGitHub

nixpkgs-broken-package

Debug and resolve Nix package build failures after flake updates.

14|Updated May 28, 2024
Search Tags:#debugging#troubleshooting#package management#nix#nixpkgs#flake
One-click install
npx skills add https://github.com/cameronraysmith/vanixiets --skill nixpkgs-broken-package
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: nixpkgs-broken-package
Source: https://github.com/cameronraysmith/vanixiets/tree/main/modules/home/ai/skills/src/core/nixpkgs-broken-package
Command: npx skills add https://github.com/cameronraysmith/vanixiets --skill nixpkgs-broken-package

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps you systematically debug and resolve issues when a Nix package breaks after a flake update, preventing build failures and ensuring system stability.

Core Features & Use Cases

  • Systematic Triage: Provides a structured workflow to identify the root cause of broken packages.
  • Scenario-Based Strategies: Offers specific solutions like stable fallbacks, build modifications, or upstream patching based on the problem's nature.
  • Use Case: After updating your Nix flake, a critical development tool fails to build. This Skill guides you through checking its status in Nixpkgs, identifying if it's a known issue, and applying the correct fix from the provided strategies.

Quick Start

Use the nixpkgs-broken-package skill to triage a broken package after a flake update.

Frequently Asked Questions about nixpkgs-broken-package

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I fix a broken Nix package after a flake update?▼

To fix a broken Nix package after a flake update, perform a systematic triage by checking the upstream status in Nixpkgs and applying targeted fixes such as stable fallbacks, overlays, or flake.lock rollbacks.

What is the best way to debug Nix build failures in NixOS or home-manager?▼

Debugging Nix build failures in NixOS or home-manager requires a structured workflow to identify the root cause of regressions, checking upstream status, and applying build modifications or patches to restore system stability.

Can I use overlays to patch a broken nixpkgs package?▼

Yes, you can use overlays to apply targeted fixes to a broken nixpkgs package, allowing you to modify the build or provide upstream patches without waiting for an official channel update.

When should I roll back flake.lock to resolve package build failures?▼

You should roll back flake.lock to resolve package build failures when a recent update introduces regressions and you need to quickly restore system stability while awaiting an upstream fix in Nixpkgs.

Does this troubleshooting workflow apply to nix-darwin configurations?▼

Yes, this systematic debugging workflow applies to nix-darwin configurations, as well as NixOS and home-manager, providing scenario-based strategies to resolve package build regressions across different Nix environments.

Related Skills

Explore More Software Engineering Skills→
richardgillrichardgill
37

upgrade-flake

Update flake.lock inputs and verify NixOS configurations before switching.

Community
Intermediate
aytordevaytordev
1

nix-module-template

Generate NixOS, Home Manager, and nix-darwin module templates with separated options and config.

Community
Basic
olafkfreundolafkfreund
21

gnome

Manage GNOME configuration declaratively for NixOS and Home Manager.

Community
Advanced
bravebrave
3.5k

check-upstream-flake

Query Chromium's LUCI Analysis database for upstream test flakiness statistics.

Official
Intermediate