---
name: nix-style
description: Use when creating, editing, or reviewing Nix files in this repository.
---

# nix-style

Use this skill as the source of truth for repository Nix conventions.

## Load rules

Read every Markdown file under [`rules/`](rules/) before applying this skill.
Discover rule files from the skill source:

```bash
find src/skills/nix-style/rules -maxdepth 1 -type f -name '*.md' -print | sort
```

Finish when all discovered rule files have been read.

## Maintain rules

When adding or changing files under [`rules/`](rules/), read [`RULE-FORMAT.md`](RULE-FORMAT.md) first.
Finish when the changed rule files follow that format.

## Apply rules

Apply the loaded rules when editing or reviewing Nix files.
When loaded rules conflict, follow the most specific rule.

After editing Nix files, run:

```bash
nix run .#fix
```

Finish when the Nix change follows the loaded rules.