selection-randomizer — Claude Code skill for picking winners
selection-randomizer is a Claude Code skill that randomly picks winners and participants from lists. It can apply weights and exclude past winners.
LicenseRef-Proprietary 133 installs ★ 50 updated 2026-01-05
npx skills add qodex-ai/ai-agent-skills --skill selection-randomizer -a claude-codeWhat selection-randomizer 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.
What it helps with
- 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 for the agent
- Choose a random giveaway winner from this Google Sheet: [link]
- Pick 3 winners from
entries.csvwithout selecting anyone twice - Split this participant list into 4 equal teams
How to install selection-randomizer
1Skills CLI (Vercel)
npx skills add qodex-ai/ai-agent-skills --skill selection-randomizer -a claude-code2Manually: put the files in place
~/.claude/skills/selection-randomizer/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/selection-randomizer/
1Skills CLI (Vercel)
npx skills add qodex-ai/ai-agent-skills --skill selection-randomizer -a codex2Manually: put the files in place
.agents/skills/selection-randomizer/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add qodex-ai/ai-agent-skills --skill selection-randomizer -a cursor2Manually: put the files in place
.cursor/skills/selection-randomizer/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install qodex-ai/ai-agent-skills skills/selection-randomizer2Manually: put the files in place
.github/skills/selection-randomizer/SKILL.md1Skills CLI (Vercel)
npx skills add qodex-ai/ai-agent-skills --skill selection-randomizer -a gemini-cli2Platform CLI
gemini skills install https://github.com/qodex-ai/ai-agent-skills --path skills/selection-randomizerManually: put the files in place
.devin/skills/selection-randomizer/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add qodex-ai/ai-agent-skills --skill selection-randomizer -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about selection-randomizer
How do I install selection-randomizer in Claude Code?
Run npx skills add qodex-ai/ai-agent-skills --skill selection-randomizer -a claude-code. The skill file is installed at ~/.claude/skills/selection-randomizer/SKILL.md.
What does selection-randomizer do?
It draws winners from lists and spreadsheets, with support for multiple picks, exclusions, and weighted entries. A seed and timestamp can be used to verify the draw.
Can entries have different chances of being picked?
Yes. The skill can base selection weights on a spreadsheet column, treating each entry in that column as a ticket.