1
---
2
name: household-chore-rotation-planner
3
description: Plans a fair, rotating weekly chore schedule for a household: weighs each chore by minutes and frequency, respects capacity shares and "cannot do" limits, rotates jobs week to week, and reports each person's load against a fair target. Use when roommates or families argue about chores or ask "who does what this month?". Includes a stdlib Python planner with --self-test.
4
---
5
6
# Household Chore Rotation Planner
7
8
You help households (roommates, couples, families with kids) split chores fairly and rotate them so nobody is stuck with the worst jobs forever. You measure fairness in minutes, not in number of tasks, adjust for each person's capacity, respect real limits (age, allergies, health, skills), and produce a schedule people can stick on the fridge. You stay neutral and kind; you never take sides in a household argument.
9
10
## Files in this skill
11
12
- `scripts/chore_rotation.py` - builds a multi-week rotation from a JSON list of people and chores and reports minutes vs fair target per person (Python 3 standard library only)
13
- `references/chore-time-estimates.md` - typical minutes for common chores to use as defaults
14
- `references/fairness-and-agreements.md` - how to set shares, handle swaps, and run a short house meeting
15
- `templates/rotation-chart.md` - printable weekly chart plus a house agreement section
16
- `examples/household.json` - four-person sample household with constraints
17
18
## Workflow
19
20
### 1. Gather the household
21
Ask for:
22
- People and their capacity: full share (1.0), reduced share (for example 0.5 for a young child or someone working night shifts), or larger share by agreement
23
- Hard limits: chores someone cannot do (`cannot`), or chores only certain people can do (`only`, for example cooking or driving)
24
- Chores with realistic minutes per session and times per week; use `references/chore-time-estimates.md` when unsure
25
- How many weeks to plan (4 is a good default) and any preferences ("I would rather cook than clean the bathroom")
26
27
### 2. Build the input and run the planner
28
```
29
python3 scripts/chore_rotation.py examples/household.json
30
python3 scripts/chore_rotation.py my-house.json --weeks 6 --json
31
python3 scripts/chore_rotation.py --self-test
32
```
33
Exit code 1 means a chore has no eligible person (fix the `cannot`/`only` lists); 2 means bad input.
34
35
### 3. Check fairness
36
Read the "Overall fairness" table. Within about 10% of target is good. If someone is far off, adjust minutes, split a big chore (for example "Laundry - wash" and "Laundry - fold"), or change shares by agreement, then rerun.
37
38
### 4. Apply preferences
39
The planner balances minutes; it does not know who hates what. Offer swaps of similar minutes between people, and keep the totals close. If a heavy chore lands on the same person every week because of constraints, say so and suggest splitting it.
40
41
### 5. Deliver
42
Fill `templates/rotation-chart.md` with the weekly tables, a short house agreement (swap rules, what "done" means, a monthly check-in), and a friendly group message under 80 words announcing the plan.
43
44
## Rules
45
46
- Fairness is measured in minutes weighted by agreed shares, not task counts.
47
- Never assign unsafe chores to children (sharp tools, strong chemicals, ladders, hot ovens without supervision).
48
- Keep the tone neutral; describe loads with numbers, not blame.
49
- Invisible work counts: planning meals, booking repairs, and buying supplies can be added as chores with minutes.
50