raffle-winner-picker

Selects random winners from lists, CSV files, spreadsheets, and Google Sheets.

Updated Jul 30, 2026
One-click install
npx skills add https://github.com/johsquaree/claude-basic-docs --skill raffle-winner-picker-johsquaree
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: raffle-winner-picker
Source: https://github.com/johsquaree/claude-basic-docs/tree/main/.claude/skills/raffle-winner-picker
Command: npx skills add https://github.com/johsquaree/claude-basic-docs --skill raffle-winner-picker-johsquaree

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Running giveaways, raffles, and contests requires a fair and transparent way to pick winners from entry lists, and manual selection is slow, error-prone, and open to bias accusations. ## Core Features & Use Cases - Random Selection from Multiple Sources: Pick one or multiple winners from CSV files, Excel spreadsheets, Google Sheets, or plain text lists using cryptographically secure randomness. - Duplicate Prevention and Exclusions: Ensure no one wins twice, exclude previous winners, and pick runner-ups as backups. - Weighted Selection: Weight entries by a column value, such as giving participants with more entries a proportionally higher chance. - Use Case: You collected 247 giveaway entries in a Google Sheet from a Google Form. Ask the Skill to pick a random winner, and it returns the winner's name, email, and entry details with a timestamp for transparent public announcement. ## Quick Start Pick a random winner from my contest entries in entries.csv and show their name and email.

Frequently Asked Questions about raffle-winner-picker

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I pick a random winner from a Google Sheet?

Provide the Google Sheet URL and ask to pick a random row as the winner. The Skill reads all entries, selects one using cryptographically secure randomness, and returns the winner's details with a timestamp for transparency.

How do I pick multiple winners without duplicates?

Specify the number of winners and request no duplicates, for example picking 5 winners from a CSV file. The Skill ensures each selected entry is unique so the same person cannot win twice.

Can I exclude previous winners from a raffle drawing?

Yes, list the names to exclude when requesting the selection, such as previous winners Alice, Bob, and Carol. The Skill removes those entries from the pool before performing the random selection.

Does the raffle picker support weighted entries?

Yes, weighted selection is supported based on a column such as an entries count, where each entry acts as one ticket. Participants with more entries receive a proportionally higher probability of being selected.

Is the random winner selection verifiable and fair?

The selection uses cryptographically secure random number generation with a recorded timestamp. A seed can be provided for third-party verification, making the process repeatable and auditable.