Raffle winner picker skill

Picks random winners from lists, spreadsheets, or Google Sheets for giveaways, raffles, and contests.

by davila7·MIT license·★ 32,299 Stars on the repo·GitHub ↗

Use now

Files of Raffle winner picker

davila7/main1 file shown
SKILL.md
Show the full text160 lines

Raffle Winner Picker

This skill randomly selects winners from lists, spreadsheets, or Google Sheets for giveaways and contests.

When to Use This Skill

  • Running social media giveaways
  • Picking raffle winners at events
  • Randomly selecting participants for surveys or tests
  • Choosing winners from contest submissions
  • Fair distribution of limited spots or resources
  • Random team assignments

What This Skill Does

  1. Random Selection: Uses cryptographically random selection
  2. Multiple Sources: Works with CSV, Excel, Google Sheets, or plain lists
  3. Multiple Winners: Can pick one or multiple winners
  4. Duplicate Prevention: Ensures the same person can't win twice
  5. Transparent Results: Shows the selection process clearly
  6. Winner Details: Displays all relevant information about winners

How to Use

From Google Sheets
Pick a random row from this Google Sheet to select a winner 
for a giveaway: [Sheet URL]
From Local File
Pick 3 random winners from entries.csv
From List
Pick a random winner from this list:
- Alice ([email protected])
- Bob ([email protected])
- Carol ([email protected])
...
Multiple Winners
Pick 5 random winners from contest-entries.xlsx, 
make sure no duplicates

Example

User: "Pick a random row from this Google Sheet to select a winner for a giveaway."

Output:

Accessing Google Sheet...
Total entries found: 247

Randomly selecting winner...

🎉 WINNER SELECTED! 🎉

Row #142
Name: Sarah Johnson
Email: [email protected]
Entry Date: March 10, 2024
Comment: "Love your newsletter!"

Selection method: Cryptographically random
Timestamp: 2024-03-15 14:32:18 UTC

Would you like to:
- Pick another winner (excluding Sarah)?
- Export winner details?
- Pick runner-ups?

Inspired by: Lenny's use case - picking a Sora 2 giveaway winner from his subscriber Slack community

Features

Fair Selection
  • Uses secure random number generation
  • No bias or patterns
  • Transparent process
  • Repeatable with seed (for verification)
Exclusions
Pick a random winner excluding previous winners: 
Alice, Bob, Carol
Weighted Selection
Pick a winner with weighted probability based on 
the "entries" column (1 entry = 1 ticket)
Runner-ups
Pick 1 winner and 3 runner-ups from the list

Example Workflows

Social Media Giveaway
  1. Export entries from Google Form to Sheets
  2. "Pick a random winner from [Sheet URL]"
  3. Verify winner details
  4. Announce publicly with timestamp
Event Raffle
  1. Create CSV of attendee names and emails
  2. "Pick 10 random winners from attendees.csv"
  3. Export winner list
  4. Email winners directly
Team Assignment
  1. Have list of participants
  2. "Randomly split this list into 4 equal teams"
  3. Review assignments
  4. Share team rosters

Tips

  • Document the process: Save the timestamp and method
  • Public announcement: Share selection details for transparency
  • Check eligibility: Verify winner meets contest rules
  • Have backups: Pick runner-ups in case winner is ineligible
  • Export results: Save winner list for records

Privacy & Fairness

✓ Uses cryptographically secure randomness ✓ No manipulation possible ✓ Timestamp recorded for verification ✓ Can provide seed for third-party verification ✓ Respects data privacy

Common Use Cases

  • Newsletter subscriber giveaways
  • Product launch raffles
  • Conference ticket drawings
  • Beta tester selection
  • Focus group participant selection
  • Random prize distribution at events
1---
2name: raffle-winner-picker
3description: Picks random winners from lists, spreadsheets, or Google Sheets for giveaways, raffles, and contests. Ensures fair, unbiased selection with transparency.
4---
5 
6# Raffle Winner Picker
7 
8This skill randomly selects winners from lists, spreadsheets, or Google Sheets for giveaways and contests.
9 
10## When to Use This Skill
11 
12- Running social media giveaways
13- Picking raffle winners at events
14- Randomly selecting participants for surveys or tests
15- Choosing winners from contest submissions
16- Fair distribution of limited spots or resources
17- Random team assignments
18 
19## What This Skill Does
20 
211. **Random Selection**: Uses cryptographically random selection
222. **Multiple Sources**: Works with CSV, Excel, Google Sheets, or plain lists
233. **Multiple Winners**: Can pick one or multiple winners
244. **Duplicate Prevention**: Ensures the same person can't win twice
255. **Transparent Results**: Shows the selection process clearly
266. **Winner Details**: Displays all relevant information about winners
27 
28## How to Use
29 
30### From Google Sheets
31 
32```
33Pick a random row from this Google Sheet to select a winner
34for a giveaway: [Sheet URL]
35```
36 
37### From Local File
38 
39```
40Pick 3 random winners from entries.csv
41```
42 
43### From List
44 
45```
46Pick a random winner from this list:
47- Alice ([email protected])
48- Bob ([email protected])
49- Carol ([email protected])
50...
51```
52 
53### Multiple Winners
54 
55```
56Pick 5 random winners from contest-entries.xlsx,
57make sure no duplicates
58```
59 
60## Example
61 
62**User**: "Pick a random row from this Google Sheet to select a winner for a giveaway."
63 
64**Output**:
65```
66Accessing Google Sheet...
67Total entries found: 247
68 
69Randomly selecting winner...
70 
71🎉 WINNER SELECTED! 🎉
72 
73Row #142
74Name: Sarah Johnson
75Email: [email protected]
76Entry Date: March 10, 2024
77Comment: "Love your newsletter!"
78 
79Selection method: Cryptographically random
80Timestamp: 2024-03-15 14:32:18 UTC
81 
82Would you like to:
83- Pick another winner (excluding Sarah)?
84- Export winner details?
85- Pick runner-ups?
86```
87 
88**Inspired by:** Lenny's use case - picking a Sora 2 giveaway winner from his subscriber Slack community
89 
90## Features
91 
92### Fair Selection
93- Uses secure random number generation
94- No bias or patterns
95- Transparent process
96- Repeatable with seed (for verification)
97 
98### Exclusions
99```
100Pick a random winner excluding previous winners:
101Alice, Bob, Carol
102```
103 
104### Weighted Selection
105```
106Pick a winner with weighted probability based on
107the "entries" column (1 entry = 1 ticket)
108```
109 
110### Runner-ups
111```
112Pick 1 winner and 3 runner-ups from the list
113```
114 
115## Example Workflows
116 
117### Social Media Giveaway
1181. Export entries from Google Form to Sheets
1192. "Pick a random winner from [Sheet URL]"
1203. Verify winner details
1214. Announce publicly with timestamp
122 
123### Event Raffle
1241. Create CSV of attendee names and emails
1252. "Pick 10 random winners from attendees.csv"
1263. Export winner list
1274. Email winners directly
128 
129### Team Assignment
1301. Have list of participants
1312. "Randomly split this list into 4 equal teams"
1323. Review assignments
1334. Share team rosters
134 
135## Tips
136 
137- **Document the process**: Save the timestamp and method
138- **Public announcement**: Share selection details for transparency
139- **Check eligibility**: Verify winner meets contest rules
140- **Have backups**: Pick runner-ups in case winner is ineligible
141- **Export results**: Save winner list for records
142 
143## Privacy & Fairness
144 
145✓ Uses cryptographically secure randomness
146✓ No manipulation possible
147✓ Timestamp recorded for verification
148✓ Can provide seed for third-party verification
149✓ Respects data privacy
150 
151## Common Use Cases
152 
153- Newsletter subscriber giveaways
154- Product launch raffles
155- Conference ticket drawings
156- Beta tester selection
157- Focus group participant selection
158- Random prize distribution at events
159 
160 

Discussion