nix-config-desktop SKILL.md skillA

nix-config-desktop 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-desktop@git:20261010.d808dd9

Pins git:20261010.d808dd9 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-desktop/SKILL.md
Versions recorded
7
Latest version
git:20261010.d808dd9, committed Oct 10, 2026
First version recorded
Oct 2, 2026
Size
6,979 bytes
Repository stars
2,104
License
MIT

Use when changing what the desktop shows or runs: Niri/Noctalia config, a window that is the wrong size, garbled, or missing after a reboot, autostart, fcitx5 or vinput input, theming and fonts, interface names a widget reads, or `$HOME` state that must survive a tmpfs root.

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

# Changing the desktop

The desktop is a Niri + Noctalia Wayland session, shared by two hosts: `ai-niri` (hostName `ai`,
x86_64) and `shoukei-niri` (hostName `shoukei`, Apple Silicon). Shared config lives in
`home/linux/gui/**`; each host adds `hosts/<dir>/niri-hardware.kdl` and its own
`home/hosts/linux/<dir>.nix`. Run `hostname` to know which one you are on.

Most of the config is deployed as **out-of-store symlinks**, so an edit takes effect live, rolls
back with git, and needs no rebuild. Only the store layer needs one.

## Core rules

1. **Edit the config layer, not the store.** Niri KDL and the Noctalia baseline are symlinked out of
   store; editing them applies immediately. A rebuild is wasted time and hides the change behind a
   generation. Scale the caution to the risk: a bar, OSD, notification, or wallpaper tweak is safe
   to try on the running session and undo with git, but a compositor, keybinding, input, output,
   idle, or portal change can take the session the user is looking at down with it. Treat that
   second kind as impactful, and do not experiment on the live desktop with it.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add ryan4yin/nix-config/nix-config-desktop@sha256:bd0f9671341f63f7

The line at the top of this page pins the label git:20261010.d808dd9, 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_pctisjiqgfl6p423.svg)](https://markdownregistry.com/a/art_pctisjiqgfl6p423)

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

Versions

The registry has recorded 7 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.d808dd9 latest2026-10-10 d808dd9 6,979 BA view · diff
git:20261010.9d698322026-10-10 9d69832 7,082 BA view · diff
git:20261010.3b630282026-10-10 3b63028 8,486 BA view · diff
git:20261010.8843df12026-10-10 8843df1 8,483 BB view · diff
git:20261010.a2cfa552026-10-10 a2cfa55 8,259 BB view · diff
git:20261002.68ea04f2026-10-02 68ea04f 7,935 BB view · diff
git:20261002.b2ec56d2026-10-02 b2ec56d 7,927 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 (6979 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_pctisjiqgfl6p423
GET https://markdownregistry.com/api/v1/resolve?ref=ryan4yin/nix-config/nix-config-desktop
GET https://markdownregistry.com/api/v1/blob/bd0f9671341f63f77ac4b50079e8b41f60f2c1273cdd9bf75bdb5b4381053368

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-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
nix-config-update SKILL.md skill
ryan4yin/nix-config · .agents/skills/nix-config-update/SKILL.md · Use when a version changes here: upgrading or updating a package or nixpkgs, bumping or pinning a flake input (a tag or…
git:20261010.0e70582 · audit A · 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.