FreePublished on GitHub

nixos

Use when the user asks about NixOS, Nix language, flakes, nixpkgs, configuration.nix, nixos-rebuild, modules, options, overlays, derivations, mkDerivation, callPackage, home-manager, nix-darwin, devenv, packaging, cross-compilation, binary caches, garbage collection, NixOS containers, networking, firewall, systemd services, filesystems, LUKS, Wayland, X11, kernel, profiles, NixOS testing or VM tests, ISO images, Docker images, Raspberry Pi, Terraform, distributed builds, remote machines, pinning nixpkgs, rollback, generations, Nix Pills, or any topic related to configuring, packaging, deploying, or troubleshooting NixOS and the Nix ecosystem.

The English summary is being prepared. Showing the original description.

marceloeatworld/nixos-ai-skill

Works withDocker Kubernetes Terraform

See how to install

Files included (50)

SKILL.md6.3 KB
.github/workflows/update-references.yml1.2 KB
.gitignore25 B
install.sh3.7 KB
README.md8.0 KB
references/.wiki-version259 B
references/best-practices.md7.5 KB
references/callpackage.md10.9 KB
references/cross-compilation.md11.7 KB
references/faq.md8.6 KB
references/first-steps.md20.5 KB
references/flakes.md15.2 KB
references/glossary.md1.3 KB
references/install-nix.md2.6 KB
references/module-system.md42.9 KB
references/nix-language.md51.1 KB
references/nix-pills.md182.4 KB
references/nixos-administration.md19.4 KB
references/nixos-binary-cache.md8.2 KB
references/nixos-building-images.md9.7 KB
references/nixos-changing-config.md3.8 KB
references/nixos-config-syntax.md12.6 KB
references/nixos-containers.md8.2 KB
references/nixos-display-server.md21.8 KB
references/nixos-distributed-builds.md10.7 KB
references/nixos-docker-tutorial.md5.3 KB
references/nixos-filesystems.md9.0 KB
references/nixos-installation.md35.1 KB
references/nixos-iso-tutorial.md1.8 KB
references/nixos-kubernetes.md4.1 KB
references/nixos-linux-kernel.md4.6 KB
references/nixos-networking.md14.4 KB
references/nixos-package-mgmt.md11.5 KB
references/nixos-profiles.md5.4 KB
references/nixos-raspberry-pi.md7.6 KB
references/nixos-remote-machines.md8.8 KB
references/nixos-terraform-tutorial.md5.7 KB
references/nixos-testing-tutorial.md11.0 KB
references/nixos-testing.md26.7 KB
references/nixos-upgrading.md5.4 KB
references/nixos-user-mgmt.md5.3 KB
references/nixos-vm-tutorial.md10.5 KB
references/nixos-writing-modules.md52.1 KB
references/packaging-tutorial.md23.8 KB
references/pinning-nixpkgs.md2.7 KB
references/recipes.md23.2 KB
references/release-process.md42.2 KB
references/troubleshooting.md3.0 KB
references/working-with-local-files.md18.4 KB
scripts/generate-references.sh19.0 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

NixOS Documentation

Complete reference for NixOS and the Nix ecosystem, auto-generated from official repositories:

nix.dev - tutorials, guides, best practices
NixOS Manual - from NixOS/nixpkgs
Nix Pills - progressive learning series
Release Wiki - NixOS release process

The references/ directory contains full, unmodified documentation from those sources, updated daily.

How to Use

Identify the topic from the user's question and read the matching reference file from the tables below.
Base answers on those files. If more detail is needed, fetch the latest docs from the raw GitHub URLs in Live Fetching.
Distinguish between NixOS module options (services.nginx.enable = true;) and Nix language expressions (pkgs.mkDerivation { ... }).
Show examples using current syntax (configuration.nix or flake-based configs). When flakes are relevant, show both the classic (channels) and flakes approach.
For packaging, prefer the callPackage pattern over raw import.
Beginners: start with references/first-steps.md or references/nix-pills.md. Troubleshooting: check references/troubleshooting.md and references/faq.md first. System issues: references/nixos-administration.md.

Reference Files

Getting Started

Topic	File
Installing Nix package manager	`references/install-nix.md`
NixOS installation (USB, PXE, VirtualBox, proxy, other distro)	`references/nixos-installation.md`
First steps (ad-hoc shells, declarative shell, reproducible scripts)	`references/first-steps.md`
Upgrading NixOS	`references/nixos-upgrading.md`
Changing NixOS configuration	`references/nixos-changing-config.md`
Glossary and terminology	`references/glossary.md`
FAQ	`references/faq.md`

Nix Language & Concepts

Topic	File
Nix language tutorial	`references/nix-language.md`
Flakes (concept and usage)	`references/flakes.md`
callPackage design pattern	`references/callpackage.md`
Module system (basics and deep dive)	`references/module-system.md`
Working with local files in Nix	`references/working-with-local-files.md`
Pinning nixpkgs versions	`references/pinning-nixpkgs.md`
Nix Pills (progressive learning, 20 lessons)	`references/nix-pills.md`

NixOS Configuration

Topic	File
Configuration syntax, modularity, abstractions	`references/nixos-config-syntax.md`
Package management (declarative, ad-hoc, custom packages)	`references/nixos-package-mgmt.md`
User management	`references/nixos-user-mgmt.md`
Networking (firewall, SSH, IPv4/6, wireless, NetworkManager)	`references/nixos-networking.md`
Filesystems (LUKS, SSHFS, OverlayFS)	`references/nixos-filesystems.md`
Display server (X11, Wayland, Xfce, GPU acceleration)	`references/nixos-display-server.md`
Linux kernel configuration	`references/nixos-linux-kernel.md`
Kubernetes	`references/nixos-kubernetes.md`
Configuration profiles (minimal, graphical, headless, etc.)	`references/nixos-profiles.md`

NixOS Administration

Topic	File
Service management, logging, rollback, troubleshooting, boot problems	`references/nixos-administration.md`
Containers (declarative, imperative, networking)	`references/nixos-containers.md`

NixOS Development

Topic	File
Writing NixOS modules (options, types, assertions)	`references/nixos-writing-modules.md`
NixOS tests (writing, running, interactive)	`references/nixos-testing.md`
Building NixOS images (ISO, systemd-repart)	`references/nixos-building-images.md`

Packaging & Build

Topic	File
Packaging existing software for nixpkgs	`references/packaging-tutorial.md`
Cross-compilation	`references/cross-compilation.md`

Tutorials

Topic	File
NixOS configuration on a VM	`references/nixos-vm-tutorial.md`
Building and running Docker images	`references/nixos-docker-tutorial.md`
Building a bootable ISO image	`references/nixos-iso-tutorial.md`
Integration testing with VMs	`references/nixos-testing-tutorial.md`
Deploying NixOS with Terraform	`references/nixos-terraform-tutorial.md`
Distributed builds setup	`references/nixos-distributed-builds.md`
NixOS on Raspberry Pi	`references/nixos-raspberry-pi.md`
Provisioning remote machines	`references/nixos-remote-machines.md`
Binary cache setup	`references/nixos-binary-cache.md`

Guides & Recipes

Topic	File
Best practices	`references/best-practices.md`
Troubleshooting	`references/troubleshooting.md`
Recipes (direnv, CI, dependencies, Python env, binary cache, sharing deps)	`references/recipes.md`

Release Process

Topic	File
NixOS release process, roles, branch-off, beta, freeze	`references/release-process.md`

Live Fetching

When reference files are insufficient, fetch the latest docs from raw GitHub:

nix.dev

https://raw.githubusercontent.com/NixOS/nix.dev/master/source/<path>.md

NixOS Manual (nixpkgs)

https://raw.githubusercontent.com/NixOS/nixpkgs/master/nixos/doc/manual/<section>/<file>.md

Nix Pills

https://raw.githubusercontent.com/NixOS/nix-pills/master/pills/<NN>-<slug>.md

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Report a problem with this skill

Install

Install with a command

npx skills add https://github.com/marceloeatworld/nixos-ai-skill --skill nixos

Paste it into your terminal and run it (requires Node.js). You can choose which agents to install it for, such as Claude Code or Codex.

Ask your agent

Please install the following Agent Skill.
https://github.com/marceloeatworld/nixos-ai-skill

First review SKILL.md and the bundled files and confirm there is nothing suspicious (such as sending data externally or reading credentials). Then place it in ~/.claude/skills/nixos/ for Claude Code, or ~/.agents/skills/nixos/ for Codex.

Send this text to Claude Code or Codex as is. It checks the contents before installing.

View source on GitHub

Repository: marceloeatworld/nixos-ai-skill
Stars: 32
Forks: 1
Category: Testing & Security
Original language: English
Last updated: Oct 22, 2026

A skill is a set of instructions and scripts for an agent. cccskills does not guarantee that skills are safe. Review the contents before you install.