# selection-randomizer

selection-randomizer is a Claude Code skill that randomly picks winners and participants from lists. It can apply weights and exclude past winners.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 133 installs · ★ 50 repo stars
- Author: qodex-ai
- License: LicenseRef-Proprietary · policy=link-only · description only; the file stays with the author
- Source: https://github.com/qodex-ai/ai-agent-skills/tree/HEAD/skills/selection-randomizer/SKILL.md
- Updated: 2026-01-05
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/selection-randomizer

## What it does

selection-randomizer draws one or more winners from a list, spreadsheet, or file. It accepts CSV, Excel, Google Sheets, and plain text lists, using a cryptographic random generator for the draw.

The skill can prevent repeat wins, use a column to weight entries, and select alternates. Results include details about the chosen participants and a timestamp. A seed and the recorded method can help verify a draw.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add qodex-ai/ai-agent-skills --skill selection-randomizer -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add qodex-ai/ai-agent-skills --skill selection-randomizer -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add qodex-ai/ai-agent-skills --skill selection-randomizer -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install qodex-ai/ai-agent-skills skills/selection-randomizer
```

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

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add qodex-ai/ai-agent-skills --skill selection-randomizer -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/qodex-ai/ai-agent-skills --path skills/selection-randomizer
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add qodex-ai/ai-agent-skills --skill selection-randomizer -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/qodex-ai/ai-agent-skills/tree/HEAD/skills/selection-randomizer/SKILL.md

## When to use it
- pick a giveaway winner from a spreadsheet
- exclude previous winners from another draw
- split participants into equal teams
- select winners and alternate participants

## Example prompts
- Choose a random giveaway winner from this Google Sheet: [link]
- Pick 3 winners from `entries.csv` without selecting anyone twice
- Split this participant list into 4 equal teams

## Similar
- [google-sheets](https://affpapa.org/en/nevibecode/skills/sanjay3290-google-sheets.md) — skill · 483 installs
- [gws-sheets](https://affpapa.org/en/nevibecode/skills/gws-sheets.md) — skill · 61900 installs
- [gws-sheets-read](https://affpapa.org/en/nevibecode/skills/gws-sheets-read.md) — skill · 52800 installs
- [Google Sheets](https://affpapa.org/en/nevibecode/mcp/google-sheets.md) — MCP server · 56138 installs
- [spreadsheet-formula-helper](https://affpapa.org/en/nevibecode/skills/spreadsheet-formula-helper.md) — skill · 3 installs
- [sheets-cli](https://affpapa.org/en/nevibecode/skills/sheets-cli.md) — skill · ★ 73 repo stars

From the same set: [qodex-ai/ai-agent-skills](https://affpapa.org/en/nevibecode/by/qodex-ai/ai-agent-skills.md) — 42 cards

---
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
