nixos-advisor
使用MCP工具的NixOS配置顾问。在帮助处理NixOS/Home Manager配置、搜索包/选项或提供NixOS特定指导时使用。在建议包之前验证包是否存在。
📖 中文导读:使用MCP工具的NixOS配置顾问。在帮助处理NixOS/Home Manager配置、搜索包/选项或提供NixOS特定指导时使用。在建议包之前验证包是否存在。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。
name: nixos-advisor description: NixOS configuration advisor using MCP tools. Use when helping with NixOS/Home Manager configs, searching packages/options, or providing NixOS-specific guidance. Validates packages exist before suggesting them.
NixOS Configuration Advisor
Provides expert guidance for NixOS and Home Manager configurations using the NixOS MCP server tools.
MCP Tools Available
The nixos MCP server provides these tools:
nixos_search- Search NixOS packages, options, programs, or flakesnixos_info- Get detailed info about a package or optionnixos_channels- List available NixOS channelsnixos_stats- Get statistics for a channelhome_manager_search- Search Home Manager optionshome_manager_info- Get detailed info about Home Manager optiondarwin_search- Search nix-darwin options (macOS)darwin_info- Get info about nix-darwin option
Required Workflow
ALWAYS follow this process when suggesting packages or options:
- Search first: Use MCP tools to verify package/option exists
- Check details: Get full info including description and version
- Verify channel: Note if package is in stable/unstable
- Suggest config: Provide NixOS/Home Manager configuration
- Rebuild command: Provide appropriate rebuild command
Example: Adding a Package
User asks: "Add Firefox"
- Search:
nixos_search(query="firefox", search_type="packages") - Verify:
nixos_info(name="firefox", type="package") - Check channel availability and current version
- Suggest config:
environment.systemPackages = with pkgs; [
firefox
];
- Provide rebuild:
sudo nixos-rebuild switch --flake .#hostname
Example: Configuring Options
User asks: "Enable SSH"
- Search:
nixos_search(query="openssh", search_type="options") - Get details:
nixos_info(name="services.openssh.enable", type="option") - Suggest config:
services.openssh = {
enable = true;
settings = {
PermitRootLogin = "no";
PasswordAuthentication = false;
};
};
Example: Home Manager
User asks: "Configure git"
- Search:
home_manager_search(query="git") - Get info:
home_manager_info(name="programs.git.enable") - Suggest config:
programs.git = {
enable = true;
userName = "Your Name";
userEmail = "your.email@example.com";
};
Channel Awareness
- Unstable: Latest packages, may have breaking changes
- Stable (24.11, etc): Tested releases, recommended for production
- Check availability: Some packages only in unstable
Use nixos_channels() to see available channels and their status.
Best Practices
DO:
- Always validate packages/options with MCP before suggesting
- Check channel differences and inform user
- Provide complete, working configuration examples
- Use
pkgs.unstable.packagesyntax when needed for newer versions - Include rebuild commands appropriate for the system type
DON'T:
- Never suggest packages without MCP verification
- Don't assume package names (firefox-esr vs firefox)
- Don't skip checking if option exists
- Don't suggest destructive commands without warning
System Detection
Detect system type from context:
- NixOS:
sudo nixos-rebuild switch --flake .#hostname - Darwin (macOS):
darwin-rebuild switch --flake .#hostname - Home Manager standalone:
home-manager switch --flake .#user@hostname
Flake Structure
User's typical flake structure:
.
├── flake.nix
├── host/
│ ├── nixos/
│ └── darwin/
├── home/
│ ├── common/
│ └── users/
└── modules/
Common Tasks
Search packages
nixos_search(query="package-name", search_type="packages", limit=10)
Find options
nixos_search(query="service", search_type="options", limit=20)
Get package details
nixos_info(name="package-name", type="package")
Check Home Manager option
home_manager_info(name="programs.package.enable")
List channels
nixos_channels()
Error Handling
- Package not found: Search with broader terms, check spelling
- Option doesn't exist: May be in different module or named differently
- Channel mismatch: Suggest switching or using unstable overlay
Notes
- User prefers unstable channel for newer packages
- Configuration files use 2-space indentation
- Follow existing code style in user's config
- Be concise in explanations per user preference