# nushell-pro

Guides an agent through writing, reviewing, debugging, and migrating Nushell code. Useful when maintaining .nu scripts or converting shell workflows.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 2500 installs · ★ 25
- Author: hustcer
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/hustcer/nushell-pro/tree/HEAD/SKILL.md
- Updated: 2026-09-27
- HTML: https://affpapa.org/en/nevibecode/skills/nushell-pro

## What it does

The skill routes tasks to focused references covering areas such as security, data types, modules, tests, and Bash conversion. It asks the agent to inspect the project’s `.nu` files, nearby tests, and conventions, then compare the project’s supported Nu versions with the locally installed version.

For generated scripts, it recommends running `nu-check --debug`, checking exact output for tricky strings or serialized data, and running relevant tests. Use `--ide-check` when structured diagnostics are needed. The guidance also covers external commands and error handling. Version details matter: it describes a `try/finally` issue in Nu 0.115.0 that is fixed in 0.116, so the project’s supported versions affect whether a workaround is appropriate.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add hustcer/nushell-pro --skill nushell-pro -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/nushell-pro/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/nushell-pro/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add hustcer/nushell-pro --skill nushell-pro -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/nushell-pro/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add hustcer/nushell-pro --skill nushell-pro -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/nushell-pro/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install hustcer/nushell-pro nushell-pro
```

2. **Manually: put the files in place**
- File: `.github/skills/nushell-pro/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add hustcer/nushell-pro --skill nushell-pro -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/hustcer/nushell-pro
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/nushell-pro/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add hustcer/nushell-pro --skill nushell-pro -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/hustcer/nushell-pro/tree/HEAD/SKILL.md

## When to use it
- write idiomatic Nushell scripts
- review `.nu` code for bugs and security issues
- convert Bash or POSIX shell code to Nushell
- debug version-specific Nu behavior
- check external command and error handling

## Example prompts
- Review this Nushell script for bugs and security risks.
- Convert this Bash script to Nushell, taking the project’s supported Nu versions into account.
- Debug why this `.nu` script fails when it runs an external command.

## Similar
- [migrate-to-shoehorn](https://affpapa.org/en/nevibecode/skills/migrate-to-shoehorn.md) — skill · 475388 installs
- [write-swift](https://affpapa.org/en/nevibecode/skills/write-swift.md) — skill · 119300 installs
- [megacave](https://affpapa.org/en/nevibecode/skills/megacave.md) — skill · 25400 installs
- [find-docs](https://affpapa.org/en/nevibecode/skills/find-docs.md) — skill · 9400 installs
- [typescript-advanced-types](https://affpapa.org/en/nevibecode/skills/typescript-advanced-types.md) — skill · 92169 installs
- [smart-explore](https://affpapa.org/en/nevibecode/skills/smart-explore.md) — skill · 7300 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md