# v0.4 - npm Distribution and Install UX

Release date: 2026-07-02

## Summary

V0.4 adds an npm distribution layer without rewriting the PowerShell core. The new `powershell-skills` CLI wraps the existing installers, adds doctor diagnostics, and provides an explicit update path.

## Added

- `package.json` for `@agent-shells/powershell-skills`.
- `bin/powershell-skills.js` CLI.
- `powershell-skills install codex`.
- `powershell-skills install claude-code`.
- `powershell-skills install all`.
- `powershell-skills doctor`.
- `powershell-skills update`.
- `--json` output for install and doctor automation.
- `--dry-run` for update inspection.
- `tests/npm-cli-smoke.js` for CLI verification.

## Installation

Install from GitHub through npm:

```powershell
npm install -g github:agent-shells/powershell-skills#v0.4
powershell-skills install all
powershell-skills doctor
```

After npm registry publishing is available:

```powershell
npm install -g @agent-shells/powershell-skills
powershell-skills install all
powershell-skills doctor
```

## Verification

```powershell
npm test
npm pack --dry-run
powershell -NoProfile -ExecutionPolicy Bypass -File .\scripts\verify-v0.1.ps1
pwsh -NoProfile -ExecutionPolicy Bypass -File .\scripts\verify-v0.1.ps1 -PowerShellExe pwsh
```

## Boundaries

- npm is a distribution and UX layer only.
- Existing PowerShell scripts remain the source of truth.
- Updates are explicit and user-triggered.
- No telemetry or failure upload was added.
- Destructive commands still require external validation and are not auto-executed.