---
name: nushell-orchestrator
description: Specialized for Nushell scripting, configuration management, and shell automation. Use when the user needs to modify nushell/config.nu, nushell/env.nu, create helper scripts in helpers/*.nu, or automate tasks using Nushell's structured data and pipeline features.
---

# Nushell Orchestrator

## Overview
This skill provides expertise in Nushell (nu), a modern shell with a structured data approach. It focuses on maintaining the user's Nushell environment and creating robust, type-safe scripts for system automation.

## Core Capabilities

### 1. Configuration Management
Manage the core Nushell configuration files located in `~/dev/dotfiles/nushell/`.
- `config.nu`: Main configuration, aliases, and hooks.
- `env.nu`: Environment variables and path setup.
- `linux.nu`, `macos.nu`, `windows.nu`: Platform-specific overrides.

### 2. Scripting & Automation
Create and maintain helper scripts in `~/dev/dotfiles/helpers/` (e.g., `liquidcfg.nu`, `wow.nu`, `setup-aoc-recording.nu`).
- Use Nushell's strong typing for script parameters (`def main [arg: string, --flag: int]`).
- Leverage structured data (JSON, YAML, TOML) parsing and generation.
- Utilize external commands safely using Nushell's `^` prefix or `run-external`.

### 3. Dotfiles Installation
Maintain `install.nu` in the root directory, which handles symlinking and environment setup across different platforms.

## Guidelines
- **Prefer Tables:** Use Nushell's built-in table manipulation (`where`, `sort-by`, `select`, `get`) instead of `grep`, `sed`, or `awk`.
- **Type Safety:** Always define types for function parameters and return values in scripts.
- **Error Handling:** Use `try { ... } catch { ... }` blocks for fragile operations like network requests or file system changes.
- **Completions:** Implement custom completions for scripts to improve the CLI experience.

## Examples
- "Add an alias to my nushell config to list files by size."
- "Create a Nushell script in helpers/ to automate my liquidctl profile switching."
- "Update install.nu to support a new configuration directory."