文档

chore-wheel-genius

试用

Smart chore assignment for families and households. Assigns tasks based on skills, schedule, and fairness scoring. Tracks who did what, detects freeloaders, rotates unpleasant tasks equitably, and generates visual chore charts and fairness reports.

它能做什么

Smart chore assignment for families and households. Assigns tasks based on skills, schedule, and fairness scoring. Tracks who did what, detects freeloaders, rotates unpleasant tasks equitably, and generates visual chore charts and fairness reports.

技能文档

Chore Wheel Genius

A standalone command-line tool for assigning household chores fairly across family members. Instead of random rotation or nagging, this system considers each person's skills, availability, chore history, and fairness score to generate optimal weekly chore assignments.

Quick Start

# Add household members
python3 scripts/chore_wheel.py add-member Mom --skills cooking,laundry
python3 scripts/chore_wheel.py add-member Dad --skills repair,cooking
python3 scripts/chore_wheel.py add-member Alice 14
python3 scripts/chore_wheel.py add-member Bob 10

# Define chores
python3 scripts/chore_wheel.py add-chore "Cook dinner" --effort 5 --freq daily --skills cooking
python3 scripts/chore_wheel.py add-chore "Take out trash" --effort 2 --freq daily
python3 scripts/chore_wheel.py add-chore "Clean bathroom" --effort 4 --freq weekly

# Generate this week's assignments
python3 scripts/chore_wheel.py assign

# Mark chores as done
python3 scripts/chore_wheel.py done Mom "Cook dinner"

# Check fairness
python3 scripts/chore_wheel.py fairness

# Weekly report
python3 scripts/chore_wheel.py report

Commands

CommandDescription
add-member [age] [--skills s1,s2]Register a household member
add-chore [--effort 1-5] [--freq daily|weekly|monthly] [--skills s1,s2]Define a chore
assign [week]Generate fair chore assignments
done Mark a chore as completed
skip Log a skipped chore
fairnessShow fairness score for each member
report [weeks]Generate a multi-week chore report
chartDisplay this week's visual chore chart
swap Swap a chore between members
list-choresShow all defined chores
list-membersShow all household members
history [weeks]Show a member's chore history

How It Works

Fairness Scoring Algorithm

Each member has a fairness score based on:

  • Total effort accumulated over time (weighted by chore difficulty)
  • Age adjustment — younger children get lighter loads
  • Skill matching — if you're skilled at cooking, you cook more (but not exclusively)
  • Recency penalty — whoever did the unpleasant chore last time gets a break

Effort-Weighted Rotation

Chores are weighted by effort (1-5):

  • Effort 1: Take out trash, water plants
  • Effort 2: Load dishwasher, feed pets
  • Effort 3: Vacuum, mop floors
  • Effort 4: Clean bathroom, deep clean kitchen
  • Effort 5: Cook a full meal, yard work

The algorithm distributes total effort evenly, not just chore count.

Unpleasant Chore Rotation

Chores like "clean the toilet" or "unclog the drain" are tracked specifically and rotated so no one person always gets stuck with them.

Age-Based Adjustments

  • Under 8: Only effort 1-2 chores
  • 8-12: Up to effort 3
  • 13+: All chores (with fairness balancing)
  • Adults: Slightly higher baseline effort tolerance

Data Storage

Data is stored in ~/.chore_wheel.json. Delete to reset.

References

  • Fairness Algorithm
  • Age-Appropriate Chores

License

MIT © Denis Voronin

相关技能

Negotiate and enforce screen time contracts with children using a fair AI-mediated system. Set per-child daily limits, create educational vs entertainment budgets, track actual usage, generate compliance report cards, and auto-grant/extend time for chores, homework, and good behavior.

1 次安装

让 Agent 自动生成 400–600 字的第一人称反思日记,并跟踪金句、决策与心情趋势。

208 次安装6 星标

Track sleep vs optimal, calculate accumulated sleep debt, and suggest evidence-based recovery schedules. Chronotype detection, quality-weighted sleep tracking, ASCII charts, and caffeine/alcohol impact monitoring.

1 次安装

Chorus (chorus.ai). Use this skill for ANY Chorus request — searching and reading data. Whenever a task involves Chorus, use this skill instead of calling th...

1 次安装

Read and manage your Skylight Calendar family hub — calendar events, chores and reward stars, shared lists (grocery/to-do), and meal plans. Triggers on phrases like "check Skylight", "what's on the family calendar", "add an event to Skylight", "what chores does [kid] have", "mark [chore] done", "add milk to the grocery list", "what's on our shopping list", "what's for dinner", "what's on the meal plan", "who's on the Skylight frame", or any request involving the Skylight frame, family calendar, chores, rewards, shared lists, or meals. Works against your own signed-in Skylight account via email + password.

15 次安装

Break a fuzzy, high-friction goal into a sequenced quest chain with prerequisite nodes, parallel branches, waiting points, Definition of Done, and the first...

11 次安装