nix-config-debug SKILL.md skillA

nix-config-debug 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-debug@git:20261010.9d69832

Pins git:20261010.9d69832 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-debug/SKILL.md
Versions recorded
7
Latest version
git:20261010.9d69832, committed Oct 10, 2026
First version recorded
Oct 2, 2026
Size
4,742 bytes
Repository stars
2,104
License
MIT

Use when something here is broken or stops working: an eval or build error, a failed activation, a dead or restarting unit, a mihomo or DNS outage, an unreachable host or MicroVM guest, or a failing CI action.

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

# Debugging this repository

Follow the global `diagnosing-bugs` skill for the process (a reproducible signal and root cause
before any fix). This skill is only the map: which layer failed, and where to look. Rolling back,
isolating a bad input bump, and the commands that destroy rollback points are in the
`nix-config-update` skill.

## Core rules

1. **Restore service first.** A down host or a dead session gets the previous generation before any
   investigation. Rolling back the machine you are on needs `sudo`, so the user does it.
2. **Name the layer before touching code.** Eval, build, activation, and runtime failures have
   different causes; a green `just test` says nothing about activation.

## 1. Localize by layer

Each layer: symptom, then where to look.

- **eval** (`just test` fails, an eval error): `just eval-host <host>` (already passes
  `--show-trace`)
- **build** (build error, hash mismatch, "marked as broken"): `just build-host <host>`, then
  `nix log <drv>`
- **activation** (the deploy fails after building): the deploy output;
  `journalctl -u home-manager-$USER -b` for Home Manager
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add ryan4yin/nix-config/nix-config-debug@sha256:04e41380f9a74600

The line at the top of this page pins the label git:20261010.9d69832, 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_hb3k3h25dqq5bits.svg)](https://markdownregistry.com/a/art_hb3k3h25dqq5bits)

3 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.9d69832 latest2026-10-10 9d69832 4,742 BA view · diff
git:20261010.3b630282026-10-10 3b63028 11,689 BA view · diff
git:20261010.a2cfa552026-10-10 a2cfa55 11,686 BB view · diff
git:20261009.0e124402026-10-09 0e12440 5,901 BB view · diff
git:20261007.124bcd82026-10-07 124bcd8 5,692 BB view · diff
git:20261004.8f0961d2026-10-04 8f0961d 5,624 BB view · diff
git:20261002.b2ec56d2026-10-02 b2ec56d 4,973 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 (4742 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_hb3k3h25dqq5bits
GET https://markdownregistry.com/api/v1/resolve?ref=ryan4yin/nix-config/nix-config-debug
GET https://markdownregistry.com/api/v1/blob/04e41380f9a74600e32383ae36442090ddd0a0f3136c925d3a723f86c3bcbea4

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-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
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.