Agent skill

Nix Code Reviewer

by Ruixi-rebirth in 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.

No licenceAuto-check passedDevelopment

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

Install Nix Code Reviewer

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

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

GitHub CLI
$ gh skill install Ruixi-rebirth/flakes nix-code-reviewer --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-code-reviewer .claude/skills/nix-code-reviewer && 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-code-reviewer
GitHub stars
100
Token cost
~289 tokens
SKILL.md length
75 words
Files
2 (incl. references)
Skills in repo
5
Repo updated
First seen
Licence
None found

At a glance

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

  • Works in 6 steps: 扫描文件:识别文件类型(NixOS 模块、Flake、普通函数库等)。 → 样式与命名检查:根据 references/best-practices.md… → 代码结构审查 → …
  • Reviewing a NixOS module or Home Manager configuration
  • SKILL.md covers 目标, 审查流程, 审查输出格式 and 参考资源
  • Calls nix

What it does

The SKILL.md is in Chinese. The agent identifies the kind of file, checks attribute, variable and boolean naming against references/best-practices.md, and inspects structure for oversized attribute sets, overuse of with at the top level and places where inherit would be cleaner. It looks for hardcoded paths or package names that should be parameters, proper use of lib.mkIf and lib.mkMerge in NixOS and Home Manager modules, unused variables and logic that lib helpers could simplify.

After the static review it runs nix fmt, and if no serious problems turned up and the project is a flake it runs nix flake check with a trace, then reports on flake integrity, formatting fixes and build definition errors. Each finding is reported with its location, a type of style, maintainability, extensibility, potential bug or flake validation, a short explanation, and an improved code sample with the design reasoning.

When your agent uses it

  • Reviewing a NixOS module or Home Manager configuration
  • Cleaning up a flake.nix before committing
  • Spotting overuse of with or hardcoded values in Nix code

Example prompts

  • “Review modules/services/nginx.nix and run the flake check afterward.”
  • “Look at my flake.nix for naming problems and anything that should be parameterized.”

Requirements

  • Nix, with nix fmt and nix flake check available

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

  1. 扫描文件:识别文件类型(NixOS 模块、Flake、普通函数库等)。
  2. 样式与命名检查:根据 references/best-practices.md 检查属性名、变量名和布尔命名。
  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

    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 Code Reviewer loads about 289 tokens when it runs, and up to ~1.7k if it reads all its reference files. Until then it costs about 44 tokens; SKILL.md has 75 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~44
When it runs · the whole SKILL.md, loaded when a task matches
~289
With references · SKILL.md plus every file in references/, read only if the agent opens them
~1.7k

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); files beside SKILL.md are not scanned.

SKILL.md

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

“协助用户编写更加整洁、惯用且易于扩展的 Nix 代码。通过识别代码库中的坏味道和反模式,提升整体项目的代码质量,并通过 nix flake check 确保 Flake 的完整性。”

— opening of SKILL.md by Ruixi-rebirth
name
nix-code-reviewer

Read the full SKILL.md on GitHub

Files

SKILL.md and 1 other file (references) in .agents/skills/nix-code-reviewer of Ruixi-rebirth/flakes.

  • SKILL.md
  • references/best-practices.md

Open the folder on GitHubat commit ad88a12

Compare with similar skills

Nix Code Reviewer 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 Code Reviewer compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Nix Code Reviewer this skillRuixi-rebirth/flakes100—~289Automated safety check: PassNone
WooCommerce Code Reviewwoocommerce/woocommerce11k3 repos~1.1kAutomated safety check: PassCustom licence
Skill Doli Code ReviewDolibarr/dolibarr7.7k1 repos~1.1kAutomated safety check: PassMIT
Dignified Python Standardsdocling-project/docling69k—~1.5kAutomated safety check: PassApache-2.0
Clean Code GuardamElnagdy/guard-skills1.3k2 repos~4.3kAutomated safety check: PassMIT
Archify Reviewtt-a1i/archify82k—~415Automated safety check: PassMIT

Similar skills

  • WooCommerce Code Review

    woocommerce/woocommerce

    Reviews WooCommerce code changes against the project's standards, flagging backend PHP architecture, naming, documentation, data integrity and testing violations.

    11k GitHub starsUsed in 3 repos~1.1k tokens
    DevelopmentAuto-check passed
  • Skill Doli Code Review

    Dolibarr/dolibarr

    Reviews Dolibarr PHP code for compliance with coding standards and security best practices, and fixes identified issues.

    7.7k GitHub starsUsed in 1 repo~1.1k tokens
    DevelopmentAuto-check passed
  • Dignified Python Standards

    docling-project/docling

    Applies opinionated production Python conventions chosen by the project's Python version: modern type syntax, pathlib, explicit checks and interface guidance.

    69k GitHub stars~1.5k tokensUpdated today
    DevelopmentAuto-check passed
  • Clean Code Guard

    amElnagdy/guard-skills

    Reviews generated or changed production code against Clean Code, SOLID, DRY, KISS, YAGNI and LLM-specific failure modes before it ships, in any language.

    1.3k GitHub starsUsed in 2 repos~4.3k tokens
    DevelopmentAuto-check passed
  • Archify Review

    tt-a1i/archify

    Review Archify issues, PRs, or code through value, cost, and impact to support evidence-based maintenance decisions. Use for issue triage, change reviews, and…

    82k GitHub stars~415 tokensUpdated today
    DevelopmentAuto-check passed
  • Code Review Skill

    awesome-skills/code-review-skill

    Provides comprehensive code review guidance for React 19, Vue 3, Angular 17+, Svelte 5, Rust, TypeScript, Java, Java 8, PHP, Ruby, Rails, Python, Django, FastAPI, Go, C/.NET, Kotlin, Swift, Dart…

    2.1k GitHub stars~2.8k tokensUpdated 1 mo ago
    DevelopmentAuto-check: notes

More from Ruixi-rebirth/flakes

  • Nix Flake Updater

    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.

    100 GitHub stars~469 tokensUpdated 20 days ago
    Auto-check passed
  • 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
  • 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

Categories

Questions about Nix Code Reviewer

What does Nix Code Reviewer do?

Reviews Nix expressions, NixOS modules and flake.nix files for style, naming, maintainability and extensibility, then runs nix fmt and nix flake check. md is in Chinese.md, and inspects structure for oversized attribute sets, overuse of with at the top level and places where inherit would be cleaner.

When should I use Nix Code Reviewer?

Nix Code Reviewer fits situations like: reviewing a NixOS module or Home Manager configuration; cleaning up a flake.nix before committing; spotting overuse of with or hardcoded values in Nix code.

How do I install Nix Code Reviewer in Claude Code?

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

How do I install Nix Code Reviewer in Codex?

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

Can I use Nix Code Reviewer 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-code-reviewer -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-code-reviewer, .gemini/skills/nix-code-reviewer, .github/skills/nix-code-reviewer and .opencode/skills/nix-code-reviewer in your project.

What does Nix Code Reviewer need to run?

Going by SKILL.md and its folder, Nix Code Reviewer needs the command-line tools its instructions call (nix). Our summary lists: Nix, with nix fmt and nix flake check available.

Does Nix Code Reviewer 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 Code Reviewer 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. Review the folder before installing.

What licence does Nix Code Reviewer use?

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

How many tokens does Nix Code Reviewer use?

About 289 tokens (SKILL.md is roughly 1.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1.4k tokens, read only when the agent opens those files.

What are the alternatives to Nix Code Reviewer?

Skills that share tags, products or a category with Nix Code Reviewer: WooCommerce Code Review (woocommerce/woocommerce, 11k stars), Skill Doli Code Review (Dolibarr/dolibarr, 7.7k stars), Dignified Python Standards (docling-project/docling, 69k stars) and Clean Code Guard (amElnagdy/guard-skills, 1.3k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Nix Code Reviewer?

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.