Agent skill

Nix Flake Updater

by Ruixi-rebirth in Ruixi-rebirth/flakes

Updates chosen or all Nix flake inputs, checks the result with nix flake check and a system rebuild, fixes warnings, then offers to commit.

No licenceAuto-check passedDevOps & Cloud

SKILL.md written in Chinese; this summary is our English description.

Install Nix Flake Updater

skills CLI
$ npx skills add Ruixi-rebirth/flakes --skill nix-flake-updater -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Ruixi-rebirth/flakes nix-flake-updater --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/Ruixi-rebirth/flakes.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/nix-flake-updater .claude/skills/nix-flake-updater && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
nix-flake-updater
GitHub stars
100
Token cost
~469 tokens
SKILL.md length
173 words
Files
2 (incl. scripts)
Skills in repo
5
Repo updated
First seen
Licence
None found

At a glance

Updates chosen or all Nix flake inputs, checks the result with nix flake check and a system rebuild, fixes warnings, then offers to commit.

  • Works in 6 steps: 识别 Inputs → 用户选择 → 执行更新 → …
  • Bumping every flake.lock input in a NixOS configuration
  • SKILL.md covers 工作流程 and 资源
  • Runs Shell scripts from its folder; calls nix

What it does

The skill walks the agent through refreshing flake.lock in a NixOS configuration. A bundled script, scripts/update_flake.sh, lists the inputs found in flake.nix and runs the update, and the agent asks which inputs you want to bump or whether to update all of them.

Verification is mandatory. The agent runs nix flake check and treats warnings about renamed, replaced, deprecated or unknown options as stop signs even when the exit code is 0, fixing the configuration before it rebuilds. The rebuild goes through a separate nixos-rebuild skill, and any failure starts a loop of reading the message, finding the cause, editing the config and retrying. Once the build is clean it asks whether to commit, handing off to a git-workflow skill with messages such as chore: update flake inputs. The SKILL.md itself is written in Chinese.

When your agent uses it

  • Bumping every flake.lock input in a NixOS configuration
  • Updating a few chosen flake inputs rather than all of them
  • Fixing renamed or deprecated options that surface after an input update
  • Verifying a lock-file update with nix flake check and a rebuild before committing

Example prompts

  • “Update all my flake inputs, rebuild the system and tell me if anything breaks.”
  • “List the inputs in flake.nix and let me choose which ones to update.”
  • “The flake check shows a renamed option warning after the update, so fix it and rebuild.”

Requirements

  • Nix with a NixOS flake.nix configuration
  • The nixos-rebuild skill's rebuild-wrapper.sh script
  • Git, for the optional commit

Workflow steps

6 steps, taken from the step headings in SKILL.md.

  1. 识别 Inputs
  2. 用户选择
  3. 执行更新
  4. 验证与修正(关键步骤)
  5. 故障排除与修正循环
  6. 提交更改

What it can do on your machine

Read from SKILL.md and the folder at commit ad88a12. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/ (Shell), which the agent can run.

    Shell commands in SKILL.md call:

    • nix

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Nix Flake Updater loads about 469 tokens when it runs. Until then it costs about 23 tokens; SKILL.md has 173 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~23
When it runs · the whole SKILL.md, loaded when a task matches
~469

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

Without a licence we can't republish the file, so here is its outline and opening line. It has 173 words (~469 tokens).

“本 Skill 自动化了更新 Nix flake inputs、通过系统重建验证更改以及提交更新的过程。”

— opening of SKILL.md by Ruixi-rebirth
name
nix-flake-updater

Read the full SKILL.md on GitHub

Files

SKILL.md and 1 other file (scripts) in .agents/skills/nix-flake-updater of Ruixi-rebirth/flakes.

  • SKILL.md
  • scripts/update_flake.sh

Open the folder on GitHubat commit ad88a12

Compare with similar skills

Nix Flake Updater next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Nix Flake Updater compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Nix Flake Updater this skillRuixi-rebirth/flakes100—~469Automated safety check: PassNone
Update .NET Distro Packagesdotnet/core22k—~4.3kAutomated safety check: NotesMIT
PR Bumpakitaonrails/my-skills216—~2.7kAutomated safety check: PassNone
CI Triageandymai/brepjs115—~3.8kAutomated safety check: PassApache-2.0
Ghostty Submodule and GhosttyKit Workflowmanaflow-ai/cmux28k1 repos~580Automated safety check: PassCustom licence
GitVersion .NET DevelopmentGitTools/GitVersion3.1k—~1.7kAutomated safety check: PassMIT

Similar skills

  • Official

    Creates and maintains the per-distro JSON files that list the native packages .NET needs on each Linux distribution, scoped to one .NET version.

    22k GitHub stars~4.3k tokensUpdated 2 days ago
    DevelopmentAuto-check: notes
  • PR Bump

    akitaonrails/my-skills

    Merge Dependabot / dependency-bot bump PRs quickly and safely.

    216 GitHub stars~2.7k tokensUpdated 17 days ago
    DevelopmentAuto-check passed
  • CI Triage

    andymai/brepjs

    This skill should be used when a brepjs GitHub Actions job is red or behaving oddly on github.com (a remote CI run, not a local pre-commit/pre-push hook) — "CI failed", "ci-pass is failing", "npm ci…

    115 GitHub stars~3.8k tokensUpdated yesterday
    Testing & QAAuto-check passed
  • Workflow rules for the Ghostty submodule in cmux: rebuilding GhosttyKit.xcframework, pushing fork changes and updating the parent submodule pointer safely.

    28k GitHub starsUsed in 1 repo~580 tokens
    DevelopmentAuto-check passed
  • GitVersion .NET Development

    GitTools/GitVersion

    Gives repository-specific .NET guidance for GitVersion: build and test commands, central package management, project layout and coding conventions.

    3.1k GitHub stars~1.7k tokensUpdated today
    DevelopmentAuto-check passed
  • OBS Plugin Dependency Upgrade

    sorayuki/obs-multi-rtmp

    Updates the obs-multi-rtmp plugin repo to the latest upstream plugin template and OBS Studio version, including dependency metadata, then rebuilds it with CMake.

    5.1k GitHub stars~609 tokensUpdated today
    DevelopmentAuto-check passed

More from Ruixi-rebirth/flakes

  • NixOS Flake Rebuild

    Ruixi-rebirth/flakes

    Rebuilds a Flake-based NixOS system through a wrapper script that validates, formats, picks the host, runs the chosen rebuild mode and checks the result.

    100 GitHub stars~356 tokensUpdated 20 days ago
    Auto-check: notes
  • Nix Code Reviewer

    Ruixi-rebirth/flakes

    Reviews Nix expressions, NixOS modules and flake.nix files for style, naming, maintainability and extensibility, then runs nix fmt and nix flake check.

    100 GitHub stars~289 tokensUpdated 20 days ago
    Auto-check passed
  • NixOS Flake Analyzer

    Ruixi-rebirth/flakes

    Produces a quick structured report on a NixOS Flake repository, covering its hosts and Nix file count, by calling the flake-stats-mcp tool.

    100 GitHub stars~199 tokensUpdated 20 days ago
    Auto-check passed
  • Git Workflow

    Ruixi-rebirth/flakes

    标准化的代码暂存、提交(包含 GPG 签名)和推送流程。当需要使用约定式提交(Conventional Commits)并处理交互式 GPG 验证时使用。

    100 GitHub stars~383 tokensUpdated 20 days ago
    Auto-check passed

Works with

Questions about Nix Flake Updater

What does Nix Flake Updater do?

Updates chosen or all Nix flake inputs, checks the result with nix flake check and a system rebuild, fixes warnings, then offers to commit. lock in a NixOS configuration.nix and runs the update, and the agent asks which inputs you want to bump or whether to update all of them.

When should I use Nix Flake Updater?

Nix Flake Updater fits situations like: bumping every flake.lock input in a NixOS configuration; updating a few chosen flake inputs rather than all of them; fixing renamed or deprecated options that surface after an input update; verifying a lock-file update with nix flake check and a rebuild before committing.

How do I install Nix Flake Updater in Claude Code?

Run `npx skills add Ruixi-rebirth/flakes --skill nix-flake-updater -a claude-code`. Or copy the skill folder (.agents/skills/nix-flake-updater in Ruixi-rebirth/flakes) into .claude/skills/nix-flake-updater in your project. Claude Code loads it when a task matches its description.

How do I install Nix Flake Updater in Codex?

Run `npx skills add Ruixi-rebirth/flakes --skill nix-flake-updater -a codex`. Or copy the skill folder (.agents/skills/nix-flake-updater in Ruixi-rebirth/flakes) into .agents/skills/nix-flake-updater in your project. Codex loads it when a task matches its description.

Can I use Nix Flake Updater in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Ruixi-rebirth/flakes --skill nix-flake-updater -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/nix-flake-updater, .gemini/skills/nix-flake-updater, .github/skills/nix-flake-updater and .opencode/skills/nix-flake-updater in your project.

What does Nix Flake Updater need to run?

Going by SKILL.md and its folder, Nix Flake Updater needs a shell for the scripts in its folder and the command-line tools its instructions call (nix). Our summary lists: Nix with a NixOS flake.nix configuration; The nixos-rebuild skill's rebuild-wrapper.sh script; Git, for the optional commit.

Does Nix Flake Updater access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Nix Flake Updater safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Nix Flake Updater use?

No licence was found for Nix Flake Updater or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Nix Flake Updater use?

About 469 tokens (SKILL.md is roughly 1.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Nix Flake Updater?

Skills that share tags, products or a category with Nix Flake Updater: Update .NET Distro Packages (dotnet/core, 22k stars), PR Bump (akitaonrails/my-skills, 216 stars), CI Triage (andymai/brepjs, 115 stars) and Ghostty Submodule and GhosttyKit Workflow (manaflow-ai/cmux, 28k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Nix Flake Updater?

Ruixi-rebirth (a GitHub user) maintains it in Ruixi-rebirth/flakes, which has 100 GitHub stars. The repository holds 5 skills in this directory. The repository was last updated on September 21, 2026.

Source: Ruixi-rebirth/flakes on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.