nixos-ai-skill
Auto-updated NixOS & Nix ecosystem documentation for AI coding assistants — works with 33+ tools via the Agent Skills standard (SKILL.md)
Install / Use
npx skills add marceloeatworld/nixos-ai-skillInstalls into whichever agent you are using.
Other
Other agent config
Quality Score
Category
Content & MediaSupported Platforms
Our assessment of nixos-ai-skill
nixos-ai-skill scores 85/100 on our quality scale, 362nd of 622 Content & Media skills we index.
Its Other is 7.9 KB long, well organised into 26 sections with 7 code examples: a thorough specification that gives an agent plenty to work with.
It has 25 GitHub stars, so there is little community track record yet; judge it on its content.
Maintenance, license and trust
- The repository was last updated today, so nixos-ai-skill is actively maintained.
- Our last check on 2026-09-23 found the source still online.
- No license is declared. By default that means all rights are reserved: you can read it, but reusing or redistributing it is not clearly permitted. Ask the author before building on it commercially.
- Its trust signals score 85/100, with 1 caution from licensing, adoption, age or documentation. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands (3 minor notes below). An AI review of the same text found nothing harmful.
- noteInstalls by piping a downloaded script into a shellline 68
curl -fsSL https://raw.githubusercontent.com/marceloeatworld/nixos-ai-skill/main/install.sh | bash -s -- --claude - noteInstalls by piping a downloaded script into a shellline 69
curl -fsSL https://raw.githubusercontent.com/marceloeatworld/nixos-ai-skill/main/install.sh | bash -s -- --cursor - noteInstalls by piping a downloaded script into a shellline 70
curl -fsSL https://raw.githubusercontent.com/marceloeatworld/nixos-ai-skill/main/install.sh | bash -s -- --windsurf
AI review by kimi-k2.7-code on 2026-09-24. Automated pattern scan on 2026-09-24. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
nixos-ai-skill compared with similar skills
All 4 of these similar skills score higher than nixos-ai-skill; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| nixos-ai-skill (this skill)by marceloeatworld | 85 | 25 | today | Other |
| Agent-Reachby Panniantong | 100 | 85.7k | 12d ago | CLAUDE.md |
| siyuanby siyuan-note | 100 | 46.5k | today | MCP Server |
| content-research-writerby ComposioHQ | 100 | 75.6k | 9d ago | SKILL.md |
| ad-campaign-analyzerby sickn33 | 100 | 46.9k | 3d ago | SKILL.md |
Frequently asked questions
- How do I install nixos-ai-skill?
- Run
npx skills add marceloeatworld/nixos-ai-skill. The install tabs above show the steps for each supported agent. - Which AI agents does nixos-ai-skill work with?
- It is written for Claude Code, Cursor, GitHub Copilot and Windsurf, as a Other file. Other agents that read the same format can often use it too.
- Is nixos-ai-skill safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands (3 minor notes below). An AI review of the same text found nothing harmful. It declares no license and scores 85/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is nixos-ai-skill still maintained?
- The repository was last updated today, so nixos-ai-skill is actively maintained.
Skill content
View source on GitHubNixOS AI Skill
Auto-updated NixOS and Nix documentation for AI coding assistants.
Uses the open Agent Skills standard (SKILL.md). Works with 33+ AI coding assistants including Claude Code, Cursor, Windsurf, GitHub Copilot, OpenAI Codex, Gemini CLI, Amp, OpenCode, Cline, Aider, Goose, Roo Code, and many more.
References are auto-generated daily from four official NixOS repositories via GitHub Actions.
Sources
| Repository | What it provides |
|-----------|-----------------|
| NixOS/nix.dev | Tutorials, guides, best practices, glossary |
| NixOS/nixpkgs nixos/doc/manual/ | NixOS manual (installation, configuration, administration, modules) |
| NixOS/nix-pills | Progressive Nix learning series (20 lessons) |
| NixOS/release-wiki | NixOS release process documentation |
Install
Quick start
Clone into whichever directory your AI tool reads context from:
# Cursor
git clone https://github.com/marceloeatworld/nixos-ai-skill.git .cursor/skills/nixos
# Windsurf
git clone https://github.com/marceloeatworld/nixos-ai-skill.git .windsurf/skills/nixos
# GitHub Copilot
git clone https://github.com/marceloeatworld/nixos-ai-skill.git .github/copilot-instructions.d/nixos
# Cline
git clone https://github.com/marceloeatworld/nixos-ai-skill.git .cline/skills/nixos
# Claude Code (global, all projects)
git clone https://github.com/marceloeatworld/nixos-ai-skill.git ~/.claude/skills/nixos
# Claude Code (project-local)
git clone https://github.com/marceloeatworld/nixos-ai-skill.git .claude/skills/nixos
# OpenCode
git clone https://github.com/marceloeatworld/nixos-ai-skill.git .opencode/skills/nixos
# Aider
git clone https://github.com/marceloeatworld/nixos-ai-skill.git .aider/skills/nixos
# Amp
git clone https://github.com/marceloeatworld/nixos-ai-skill.git .amp/skills/nixos
# ForgeCode
git clone https://github.com/marceloeatworld/nixos-ai-skill.git .forgecode/skills/nixos
# Gemini CLI
git clone https://github.com/marceloeatworld/nixos-ai-skill.git .gemini/skills/nixos
# OpenAI Codex
git clone https://github.com/marceloeatworld/nixos-ai-skill.git .agents/skills/nixos
# Cross-agent standard (works with any Agent Skills compatible tool)
git clone https://github.com/marceloeatworld/nixos-ai-skill.git .agents/skills/nixos
With the install script
curl -fsSL https://raw.githubusercontent.com/marceloeatworld/nixos-ai-skill/main/install.sh | bash -s -- --claude
curl -fsSL https://raw.githubusercontent.com/marceloeatworld/nixos-ai-skill/main/install.sh | bash -s -- --cursor
curl -fsSL https://raw.githubusercontent.com/marceloeatworld/nixos-ai-skill/main/install.sh | bash -s -- --windsurf
curl -fsSL https://raw.githubusercontent.com/marceloeatworld/nixos-ai-skill/main/install.sh | bash -s -- --copilot
curl -fsSL https://raw.githubusercontent.com/marceloeatworld/nixos-ai-skill/main/install.sh | bash -s -- --opencode
curl -fsSL https://raw.githubusercontent.com/marceloeatworld/nixos-ai-skill/main/install.sh | bash -s -- --amp
curl -fsSL https://raw.githubusercontent.com/marceloeatworld/nixos-ai-skill/main/install.sh | bash -s -- --custom /path/you/want
Run ./install.sh --help for all options.
Update
git -C <install-path> pull
The references are updated daily by GitHub Actions, so git pull always gives you the latest documentation.
What it covers
| Category | Topics | |----------|--------| | Getting Started | Installing Nix, NixOS installation, first steps, upgrading, FAQ, glossary | | Nix Language | Language tutorial, flakes, callPackage, module system, pinning nixpkgs | | NixOS Configuration | Syntax, packages, users, networking, filesystems, display server, kernel, profiles | | Administration | Service management, logging, rollback, containers, troubleshooting | | Development | Writing modules, NixOS tests, building images | | Packaging | Packaging tutorial, cross-compilation | | Tutorials | VM setup, Docker images, ISO building, Terraform, distributed builds, Raspberry Pi | | Guides | Best practices, recipes (direnv, CI, Python, binary cache), troubleshooting | | Nix Pills | 20-lesson progressive learning series (derivations, stdenv, callPackage, etc.) | | Release Process | Roles, branch-off, beta phase, feature freeze, release steps |
How it works
User asks about NixOS / Nix
|
v
AI reads matching reference file from references/
|
v
If more detail needed -> fetch latest from raw.githubusercontent.com
|
v
Answer with correct Nix syntax and configuration.nix / flake.nix examples
The SKILL.md file acts as a routing table: it maps topics to reference files and provides fallback URLs for live fetching.
The references/ directory contains full unmodified documentation from four official NixOS repos — not summaries.
How references stay up to date
A GitHub Actions workflow runs daily:
- Clones
NixOS/nix.dev,NixOS/nix-pills,NixOS/release-wiki(shallow) - Sparse-checkouts
NixOS/nixpkgsfornixos/doc/manual/only - Runs
scripts/generate-references.shto regenerate all reference files - If anything changed, commits and pushes
You can also regenerate manually:
bash scripts/generate-references.sh
Structure
nixos-ai-skill/
├── SKILL.md # Main instruction file (topic -> reference map)
├── install.sh # Multi-tool install script
├── scripts/
│ └── generate-references.sh # Fetches docs and generates references
├── .github/workflows/
│ └── update-references.yml # Daily auto-update from official repos
└── references/ # Auto-generated (~40 files)
├── .wiki-version # Source commit tracker (all 4 repos)
├── nix-language.md # Nix language tutorial
├── flakes.md # Flakes concept
├── first-steps.md # Getting started with Nix
├── nixos-installation.md # NixOS installation guide
├── nixos-networking.md # Networking configuration
├── nixos-writing-modules.md # Module development
├── nix-pills.md # All 20 Nix Pills
└── ...
Compatibility
Built on the open Agent Skills standard (SKILL.md). Compatible with 33+ AI coding tools:
| Tool | Install path |
|------|-------------|
| Cross-agent standard | .agents/skills/nixos |
| Claude Code (global) | ~/.claude/skills/nixos |
| Claude Code (project) | .claude/skills/nixos |
| Cursor | .cursor/skills/nixos |
| Windsurf | .windsurf/skills/nixos |
| GitHub Copilot / VS Code | .github/skills/nixos |
| OpenAI Codex | .agents/skills/nixos |
| Gemini CLI | .gemini/skills/nixos |
| Amp | .amp/skills/nixos |
| OpenCode | .opencode/skills/nixos |
| Cline | .cline/skills/nixos |
| Aider | .aider/skills/nixos |
| Goose | .goose/skills/nixos |
| Roo Code | .roo/skills/nixos |
For tools not listed, clone into whichever directory your tool reads context/rules from.
Examples
> How do I set up a NixOS configuration with flakes?
> What's the difference between nix-shell and nix develop?
> How do I add a custom package to my NixOS system?
> Configure Nginx with HTTPS on NixOS
> How do I write a NixOS module with custom options?
> What is callPackage and how does it work?
> How do I set up full disk encryption with LUKS on NixOS?
> Run NixOS tests for my module
Credits
Related Skills
Agent-Reach
85.7kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
siyuan
46.5kAn open-source, privacy-first, self-hosted knowledge workspace where humans and AI agents work together 开源、隐私优先、自托管的知识工作空间，让人与智能体在此协作
content-research-writer
75.6kAssists in writing high-quality content by conducting research, adding citations, improving hooks, iterating on outlines, and providing real-time feedback on each section. Transforms your writing process from solo effort to collaborative partnership.
ad-campaign-analyzer
46.9kAnalyze cross-channel campaign data, quantify uncertainty, and propose evidence-labeled budget tests without overstating causality.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.