---
name: password-gen
description: Generate strong passwords + passphrases in multiple modes. Random ASCII (with tunable charset), memorable diceware passphrase (EFF wordlist, configurable separator + word count), pronounceable, hex, alphanumeric-only, PIN. Optional `--copy` puts it on the macOS clipboard, `--qty N` generates a batch, `--strength` shows entropy bits. Pure stdlib + bundled EFF short wordlist. Use when the user asks for a password, passphrase, "generate a strong password", "diceware", "random pin", or needs to produce credentials for an account.
---


# password-gen

## Strong random password (default)

```bash
python3 ~/.claude/skills/password-gen/scripts/gen.py
# 24 char password, mixed-case + digits + symbols
```

## Custom length

```bash
python3 ~/.claude/skills/password-gen/scripts/gen.py --length 32
```

## Passphrase (4 words, EFF short list)

```bash
python3 ~/.claude/skills/password-gen/scripts/gen.py --mode passphrase
# correct-horse-battery-staple
```

## Passphrase, custom config

```bash
python3 ~/.claude/skills/password-gen/scripts/gen.py --mode passphrase --words 6 --separator "-" --capitalize
# Trickle-Mother-Buzz-Tweet-Forensic-Reflux
```

## Pronounceable

```bash
python3 ~/.claude/skills/password-gen/scripts/gen.py --mode pronounceable --length 12
# zonibafer42
```

## Hex / alphanumeric / PIN

```bash
python3 ~/.claude/skills/password-gen/scripts/gen.py --mode hex --length 32
# a3f9b2...
python3 ~/.claude/skills/password-gen/scripts/gen.py --mode alphanumeric --length 16
python3 ~/.claude/skills/password-gen/scripts/gen.py --mode pin --length 6
# 4-6 digit PIN
```

## Batch + clipboard

```bash
python3 ~/.claude/skills/password-gen/scripts/gen.py --qty 5
# prints 5 candidates so you can pick one

python3 ~/.claude/skills/password-gen/scripts/gen.py --copy
# generates one and pipes to pbcopy on macOS
```

## Show entropy

```bash
python3 ~/.claude/skills/password-gen/scripts/gen.py --strength
# strong-hare-vinyl-jackpot-frock  (entropy: 64.6 bits)
```

## Flags

- `--mode` — `random` (default), `passphrase`, `pronounceable`, `hex`, `alphanumeric`, `pin`
- `--length` — character count (default 24 for random)
- `--words` — passphrase word count (default 4)
- `--separator` — passphrase separator (default `-`)
- `--capitalize` — passphrase Title-Case
- `--include-number` — passphrase appends a random digit
- `--no-symbols` — exclude `!@#$%^&*()-_=+[]{}<>?` from random mode
- `--no-ambiguous` — exclude `0Ol1I` (good for handwritten passwords)
- `--qty` — generate N candidates
- `--copy` — copy result to macOS clipboard
- `--strength` — show entropy bits

## Pairs well with

- `dot-vault` — generate a vault password, then encrypt your `.env`