nix-config-update SKILL.md skillA

nix-config-update from ryan4yin/nix-config is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add ryan4yin/nix-config/nix-config-update@git:20261010.0e70582

Pins git:20261010.0e70582 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
ryan4yin/nix-config
Path
.agents/skills/nix-config-update/SKILL.md
Versions recorded
8
Latest version
git:20261010.0e70582, committed Oct 10, 2026
First version recorded
Oct 2, 2026
Size
8,718 bytes
Repository stars
2,104
License
MIT

Use when a version changes here: upgrading or updating a package or nixpkgs, bumping or pinning a flake input (a tag or commit, not a branch), or deploying the result to hosts, VMs, and MicroVM guests.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Updating this flake safely

Read this before running `just up`, `just upp`, `just up-nix`, or `just override-pkgs`, and before
deploying the result to any host.

## Core rules

1. **Update and deploy are two steps.** Never fold "bump the lock file" and "switch every host" into
   one blind action.
2. **Validate before touching a host.** An update is only a candidate until `just test` is green and
   the affected hosts build locally.
3. **One reviewable commit per update.** The convention here is a `flake.lock: Update` commit for
   the bump; a config change gets its own commit or PR.
4. **Keep a way back.** Anything that reaches a host needs a rollback path: the previous generation,
   `boot` mode, `just darwin-rollback`, or `git revert`.
5. **Security first.** An update re-opens the supply chain. Re-audit every input whose revision
   moved before you deploy it.
6. **Pin third-party inputs.** A third-party input — not one of the user's own `ryan4yin/*`
   repositories — MUST name a version tag or a fixed commit, not a branch. Official channel
   upstreams that publish no release (nixpkgs' `nixos-unstable`/`master`) are the exception. When
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add ryan4yin/nix-config/nix-config-update@sha256:03589c7a16d676e7

The line at the top of this page pins the label git:20261010.0e70582, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_nawx2zg2tomh3uxx.svg)](https://markdownregistry.com/a/art_nawx2zg2tomh3uxx)

3 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 8 versions of this file, between Oct 2, 2026 and Oct 10, 2026, about one every day. Its first recorded version is graded B and its latest A.

versioncommittedcommitsizeaudit
git:20261010.0e70582 latest2026-10-10 0e70582 8,718 BA view · diff
git:20261010.d808dd92026-10-10 d808dd9 9,183 BA view · diff
git:20261010.3b630282026-10-10 3b63028 9,329 BA view · diff
git:20261010.60b80e62026-10-10 60b80e6 9,326 BB view · diff
git:20261010.a2cfa552026-10-10 a2cfa55 9,281 BB view · diff
git:20261008.9ba2cf52026-10-08 9ba2cf5 9,310 BB view · diff
git:20261007.124bcd82026-10-07 124bcd8 8,865 BB view · diff
git:20261002.b2ec56d2026-10-02 b2ec56d 8,886 BB view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (8718 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

ryan4yin/nix-config · 2,104 stars · license MIT · pushed 2026-10-21 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_nawx2zg2tomh3uxx
GET https://markdownregistry.com/api/v1/resolve?ref=ryan4yin/nix-config/nix-config-update
GET https://markdownregistry.com/api/v1/blob/03589c7a16d676e738991f134c6f483a19b99a7c042fa12656b4f407af7f6324

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from ryan4yin/nix-config

nix-config-debug SKILL.md skill
ryan4yin/nix-config · .agents/skills/nix-config-debug/SKILL.md · Use when something here is broken or stops working: an eval or build error, a failed activation, a dead or restarting…
git:20261010.9d69832 · audit A · 2,104 stars
nix-config-desktop SKILL.md skill
ryan4yin/nix-config · .agents/skills/nix-config-desktop/SKILL.md · Use when changing what the desktop shows or runs: Niri/Noctalia config, a window that is the wrong size, garbled, or…
git:20261010.d808dd9 · audit A · 2,104 stars
nix-config-new-host SKILL.md skill
ryan4yin/nix-config · .agents/skills/nix-config-new-host/SKILL.md
git:20261010.0e70582 · audit B · 2,104 stars
nix-config-secrets SKILL.md skill
ryan4yin/nix-config · .agents/skills/nix-config-secrets/SKILL.md
git:20261010.0e70582 · audit B · 2,104 stars
nix-config-umu-game SKILL.md skill
ryan4yin/nix-config · .agents/skills/nix-config-umu-game/SKILL.md
git:20261010.0e70582 · audit B · 2,104 stars
nixpkgs-patched SKILL.md skill
ryan4yin/nix-config · .agents/skills/nixpkgs-patched/SKILL.md
git:20261010.a2cfa55 · audit B · 2,104 stars
nixpkgs-review SKILL.md skill
ryan4yin/nix-config · .agents/skills/nixpkgs-review/SKILL.md
git:20261010.0e70582 · audit B · 2,104 stars
AGENTS.md AGENTS.md file
ryan4yin/nix-config · AGENTS.md
git:20261014.72a7a2a · audit A · 2,104 stars
find-docs SKILL.md skill
ryan4yin/nix-config · agents/skills/find-docs/SKILL.md · Look up current documentation and code examples for a library, framework, SDK, CLI tool, or cloud service with the…
git:20261010.7b21ea5 · audit A · 2,104 stars
git-delivery SKILL.md skill
ryan4yin/nix-config · agents/skills/git-delivery/SKILL.md
git:20261010.7bba1ab · audit B · 2,104 stars
review-comments-and-docs SKILL.md skill
ryan4yin/nix-config · agents/skills/review-comments-and-docs/SKILL.md
git:20261011.f32d67a · audit B · 2,104 stars

Every file in ryan4yin/nix-config

Browse by kind, by grade A, or by owner.