{"id":"08f280f9-01e3-4238-b75d-fe500a0c5cb5","entityType":"agent","slug":"clawhub-voronindenis5-chore-wheel-genius","name":"chore-wheel-genius","canonicalUrl":"https://www.xpersona.co/agent/clawhub-voronindenis5-chore-wheel-genius","canonicalPath":"/agent/clawhub-voronindenis5-chore-wheel-genius","generatedAt":"2026-10-10T10:45:01.094Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-10-10T06:45:54.440Z","emptyReason":null},"description":"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. Skill: chore-wheel-genius Owner: voronindenis5 Summary: 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. Tags: latest:0.1.0 Version history: v0.1.0 | 2026-08-14T06:17:45.453Z | auto Initial release of Chore Wheel Genius.","descriptionLabel":"Technical summary","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 1.6K downloads reported by the source. Last updated 10/10/2026.","installCommand":"clawhub skill install s17b6amkd3wzqgg640v03a9r1n83gxs1:chore-wheel-genius","sourceUrl":"https://clawhub.ai/voronindenis5/chore-wheel-genius","homepage":"https://clawhub.ai/voronindenis5/skills/chore-wheel-genius","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/voronindenis5/chore-wheel-genius","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/voronindenis5/skills/chore-wheel-genius","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":64,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"Smart chore assignment for families and households. Assigns tasks based on skills, schedule, and fairness scoring. Tracks who did what, detects freeloaders, rot"},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-10T06:45:54.440Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[],"verifiedCount":0,"selfDeclaredCount":1,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile"}},"adoption":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-10T06:45:54.440Z","emptyReason":null},"stars":null,"forks":null,"downloads":1611,"packageName":null,"latestVersion":"0.1.0","tractionLabel":"1.6K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-10T06:45:54.440Z","emptyReason":null},"lastUpdatedAt":"2026-10-10T06:45:54.440Z","lastCrawledAt":"2026-10-10T06:45:54.440Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-11T06:45:54.440Z","lastVerifiedAt":null,"highlights":[{"version":"0.1.0","createdAt":"2026-08-14T06:17:45.453Z","changelog":"Initial release of Chore Wheel Genius. - Fairly assigns household chores based on skills, availability, age, and chore history. - Supports chore rotation, unpleasant chore tracking, and effort-weighted balancing. - Tracks completions, detects freeloaders, and provides fairness scores. - Generates chore charts and multi-week fairness reports. - Command-line interface for adding members/chores, assigning, tracking, and reporting.","fileCount":10,"zipByteSize":13869}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s17b6amkd3wzqgg640v03a9r1n83gxs1:chore-wheel-genius","setupComplexity":"low","setupSteps":["Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.","Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data."],"contract":{"contractStatus":"missing","authModes":[],"requires":[],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":null,"outputSchemaRef":null,"dataRegion":null,"contractUpdatedAt":null,"sourceUpdatedAt":null,"freshnessSeconds":null},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-voronindenis5-chore-wheel-genius/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-voronindenis5-chore-wheel-genius/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-voronindenis5-chore-wheel-genius/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-voronindenis5-chore-wheel-genius/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-voronindenis5-chore-wheel-genius/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-voronindenis5-chore-wheel-genius/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"CLAWHUB","generatedAt":"2026-10-10T10:45:01.094Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-voronindenis5-chore-wheel-genius/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-voronindenis5-chore-wheel-genius/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-voronindenis5-chore-wheel-genius/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-voronindenis5-chore-wheel-genius/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":["Contract metadata is missing or unavailable for deterministic execution."],"safeUseWhen":[],"riskFlags":["missing_or_unavailable_contract","trust_data_unavailable","schema_references_missing"],"operationalConfidence":"low"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"high","updatedAt":"2026-10-10T06:45:54.440Z","emptyReason":null},"readme":"Skill: chore-wheel-genius\n\nOwner: voronindenis5\n\nSummary: 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.\n\nTags: latest:0.1.0\n\nVersion history:\n\nv0.1.0 | 2026-08-14T06:17:45.453Z | auto\n\nInitial release of Chore Wheel Genius.\n\n- Fairly assigns household chores based on skills, availability, age, and chore history.\n- Supports chore rotation, unpleasant chore tracking, and effort-weighted balancing.\n- Tracks completions, detects freeloaders, and provides fairness scores.\n- Generates chore charts and multi-week fairness reports.\n- Command-line interface for adding members/chores, assigning, tracking, and reporting.\n\nArchive index:\n\nArchive v0.1.0: 10 files, 13869 bytes\n\nFiles: LICENSE (1070b), README.md (2506b), references (0b), references/age-chores.md (2408b), references/fairness-algorithm.md (2623b), scripts (0b), scripts/chore_wheel.py (19204b), skill-card.md (2270b), SKILL.md (3683b), _meta.json (137b)\n\nFile v0.1.0:SKILL.md\n\n---\nname: chore-wheel-genius\nversion: 1.0.0\nauthor: Denis Voronin\nlicense: MIT\ndescription: >\n Smart chore assignment for families and households. Assigns tasks based on\n skills, schedule, and fairness scoring. Tracks who did what, detects\n freeloaders, rotates unpleasant tasks equitably, and generates visual\n chore charts and fairness reports.\ntags:\n - household\n - chores\n - family\n - fairness\n - scheduling\n---\n\n# Chore Wheel Genius\n\nA standalone command-line tool for assigning household chores fairly across\nfamily members. Instead of random rotation or nagging, this system considers\neach person's skills, availability, chore history, and fairness score to\ngenerate optimal weekly chore assignments.\n\n## Quick Start\n\n```bash\n# Add household members\npython3 scripts/chore_wheel.py add-member Mom --skills cooking,laundry\npython3 scripts/chore_wheel.py add-member Dad --skills repair,cooking\npython3 scripts/chore_wheel.py add-member Alice 14\npython3 scripts/chore_wheel.py add-member Bob 10\n\n# Define chores\npython3 scripts/chore_wheel.py add-chore \"Cook dinner\" --effort 5 --freq daily --skills cooking\npython3 scripts/chore_wheel.py add-chore \"Take out trash\" --effort 2 --freq daily\npython3 scripts/chore_wheel.py add-chore \"Clean bathroom\" --effort 4 --freq weekly\n\n# Generate this week's assignments\npython3 scripts/chore_wheel.py assign\n\n# Mark chores as done\npython3 scripts/chore_wheel.py done Mom \"Cook dinner\"\n\n# Check fairness\npython3 scripts/chore_wheel.py fairness\n\n# Weekly report\npython3 scripts/chore_wheel.py report\n```\n\n## Commands\n\n| Command | Description |\n|---------|-------------|\n| `add-member [age] [--skills s1,s2]` | Register a household member |\n| `add-chore [--effort 1-5] [--freq daily\\|weekly\\|monthly] [--skills s1,s2]` | Define a chore |\n| `assign [week]` | Generate fair chore assignments |\n| `done ` | Mark a chore as completed |\n| `skip ` | Log a skipped chore |\n| `fairness` | Show fairness score for each member |\n| `report [weeks]` | Generate a multi-week chore report |\n| `chart` | Display this week's visual chore chart |\n| `swap ` | Swap a chore between members |\n| `list-chores` | Show all defined chores |\n| `list-members` | Show all household members |\n| `history [weeks]` | Show a member's chore history |\n\n## How It Works\n\n### Fairness Scoring Algorithm\nEach member has a **fairness score** based on:\n- **Total effort** accumulated over time (weighted by chore difficulty)\n- **Age adjustment** โ€” younger children get lighter loads\n- **Skill matching** โ€” if you're skilled at cooking, you cook more (but not exclusively)\n- **Recency penalty** โ€” whoever did the unpleasant chore last time gets a break\n\n### Effort-Weighted Rotation\nChores are weighted by effort (1-5):\n- Effort 1: Take out trash, water plants\n- Effort 2: Load dishwasher, feed pets\n- Effort 3: Vacuum, mop floors\n- Effort 4: Clean bathroom, deep clean kitchen\n- Effort 5: Cook a full meal, yard work\n\nThe algorithm distributes total effort evenly, not just chore count.\n\n### Unpleasant Chore Rotation\nChores like \"clean the toilet\" or \"unclog the drain\" are tracked specifically\nand rotated so no one person always gets stuck with them.\n\n### Age-Based Adjustments\n- Under 8: Only effort 1-2 chores\n- 8-12: Up to effort 3\n- 13+: All chores (with fairness balancing)\n- Adults: Slightly higher baseline effort tolerance\n\n## Data Storage\n\nData is stored in `~/.chore_wheel.json`. Delete to reset.\n\n## References\n\n- [Fairness Algorithm](references/fairness-algorithm.md)\n- [Age-Appropriate Chores](references/age-chores.md)\n\n## License\n\nMIT ยฉ Denis Voronin\n\nFile v0.1.0:README.md\n\n# Chore Wheel Genius ๐Ÿ โœจ\n\nEnd chore wars forever. This tool assigns household tasks fairly based on\nskills, availability, age, and past effort โ€” so nobody feels overworked and\nnobody gets a free ride.\n\n## The Problem\n\nEvery household fights about chores:\n- **\"That's not fair!\"** โ€” someone always feels they do more\n- **\"It's not my turn!\"** โ€” rotation is random or forgotten\n- **\"I always get the gross chores!\"** โ€” unpleasant tasks pile on one person\n- **\"I don't know how to do that.\"** โ€” no skill matching\n- **\"I was busy!\"** โ€” no flexibility for schedules\n- **No accountability** โ€” nobody remembers who actually did what\n\n## The Solution\n\nAn effort-weighted, skill-matched, fairness-optimized chore assignment system:\n\n1. Each member gets chores matched to their skills and age\n2. Total effort is balanced โ€” not just chore count\n3. Unpleasant tasks rotate so nobody is stuck\n4. History tracks who actually did what\n5. Fairness scores reveal who's carrying the load\n\n## Features\n\n- ๐Ÿ‘จโ€๐Ÿ‘ฉโ€๐Ÿ‘งโ€๐Ÿ‘ฆ **Multi-person households** โ€” kids and adults with different capabilities\n- โš–๏ธ **Effort-weighted assignment** โ€” 5 trash runs โ‰  5 bathroom cleans\n- ๐ŸŽฏ **Skill matching** โ€” cooks cook, handypeople fix, everyone learns\n- ๐Ÿ”„ **Unpleasant chore rotation** โ€” nobody always cleans the toilet\n- ๐Ÿ“Š **Fairness scores** โ€” quantitative, not emotional\n- ๐Ÿ“… **Flexible scheduling** โ€” daily, weekly, monthly frequencies\n- ๐Ÿ“ˆ **History tracking** โ€” see trends and who's slacking\n- ๐Ÿ† **Praise detection** โ€” identify the unsung heroes of the household\n- ๐Ÿ“‹ **Visual charts** โ€” printable weekly chore chart\n\n## Quick Start\n\n```bash\n# Set up household\npython3 scripts/chore_wheel.py add-member Mom --skills cooking,laundry\npython3 scripts/chore_wheel.py add-member Dad --skills repair,cooking\npython3 scripts/chore_wheel.py add-member Alice 14\npython3 scripts/chore_wheel.py add-member Bob 10\n\n# Define chores\npython3 scripts/chore_wheel.py add-chore \"Cook dinner\" --effort 5 --freq daily --skills cooking\npython3 scripts/chore_wheel.py add-chore \"Take out trash\" --effort 2 --freq daily\npython3 scripts/chore_wheel.py add-chore \"Clean bathroom\" --effort 4 --freq weekly\n\n# Generate assignments\npython3 scripts/chore_wheel.py assign\n\n# Track completion\npython3 scripts/chore_wheel.py done Alice \"Take out trash\"\n\n# Check fairness\npython3 scripts/chore_wheel.py fairness\n```\n\n## Requirements\n\n- Python 3.6+ (stdlib only)\n\n## License\n\nMIT ยฉ Denis Voronin\n\nFile v0.1.0:_meta.json\n\n{\n \"ownerId\": \"kn75wwn4x6djaf28jbykeamazd81gtdp\",\n \"slug\": \"chore-wheel-genius\",\n \"version\": \"0.1.0\",\n \"publishedAt\": 1786688265453\n}\n\nFile v0.1.0:references/age-chores.md\n\n# Age-Appropriate Chores\n\n## Developmental Chore Guide\n\n### Ages 2-3\n**Capabilities:** Imitation, simple one-step tasks\n- Pick up toys\n- Put clothes in hamper\n- Wipe up spills (with help)\n- Feed pets (with supervision)\n\n### Ages 4-5\n**Capabilities:** Following simple instructions, desire to \"help\"\n- Make bed (loosely)\n- Set napkins/silverware on table\n- Water plants\n- Sort socks in laundry\n- Dust low surfaces\n- Clear own plate\n\n### Ages 6-7\n**Capabilities:** More independence, simple routines\n- Make bed properly\n- Fold and put away own clothes\n- Set the table\n- Sweep small areas\n- Pack own school bag\n- Feed pets independently\n- Weed garden (with direction)\n\n### Ages 8-10\n**Capabilities:** Multi-step tasks, following checklists\n- Load/unload dishwasher\n- Vacuum\n- Take out trash\n- Clean own bedroom thoroughly\n- Help with cooking (simple tasks)\n- Fold laundry\n- Wipe down counters\n- Clean sinks\n\n### Ages 11-13\n**Capabilities:** Nearly independent, can manage own checklist\n- Cook simple meals (eggs, pasta, sandwiches)\n- Do own laundry completely\n- Clean bathroom (sink, toilet, mirror)\n- Mop floors\n- Grocery shopping (with list)\n- Wash the car\n- Change bed sheets\n- Take pets for walks\n\n### Ages 14-17\n**Capabilities:** Full chore competence, can handle any household task\n- Cook full family meals\n- Deep clean any room\n- Yard work (mowing, raking)\n- Minor home repairs\n- Manage household budget for groceries\n- Babysit younger siblings\n- Handle trash/recycling completely\n\n## Why Age-Appropriate Chores Matter\n\n1. **Building competence**: Children learn life skills gradually\n2. **Confidence**: Success at appropriately challenging tasks builds self-esteem\n3. **Family contribution**: Everyone contributes according to ability\n4. **Independence**: Chore skills transfer to adult life\n\n## Implementation in This Tool\n\n```python\nAGE_EFFORT_CAP = {\n range(2, 4): 1, # Only effort-1 chores\n range(4, 6): 2, # Up to effort-2\n range(6, 8): 2,\n range(8, 11): 3, # Up to effort-3\n range(11, 14): 4, # Up to effort-4\n range(14, 200): 5, # All chores\n}\n\nAGE_EFFORT_MULTIPLIER = {\n range(0, 6): 0.0,\n range(6, 8): 0.3,\n range(8, 11): 0.5,\n range(11, 14): 0.7,\n range(14, 18): 0.85,\n range(18, 200): 1.0,\n}\n```\n\n## Sources\n\n- American Academy of Pediatrics (AAP) child development guidelines\n- Montessori practical life curriculum\n- CDC developmental milestones\n\nFile v0.1.0:references/fairness-algorithm.md\n\n# Fairness Algorithm\n\n## Core Principle\n\nFairness in a household is not about doing the same *number* of chores โ€” it's\nabout contributing the same *amount of effort* adjusted for age and ability.\n\n## Effort Scoring\n\nEach chore has an effort score (1-5):\n\n| Effort | Description | Examples |\n|--------|-------------|----------|\n| 1 | Minimal | Water plants, feed pet, sort mail |\n| 2 | Light | Take out trash, load dishwasher, dust |\n| 3 | Moderate | Vacuum, mop, grocery shopping |\n| 4 | Heavy | Clean bathroom, deep clean kitchen, yard work |\n| 5 | Very Heavy | Cook full meal, major repair, move furniture |\n\n## Fairness Calculation\n\n### Per-Member Effort Target\n\nFor a household of N members, the weekly effort target per member is:\n\n```\ntarget = total_chore_effort / N ร— age_multiplier\n```\n\n### Age Multipliers\n\n| Age | Multiplier | Rationale |\n|------|-----------|-----------|\n| < 6 | 0.0 | Too young for chores |\n| 6-7 | 0.3 | Light participation |\n| 8-10 | 0.5 | Half the adult load |\n| 11-13 | 0.7 | Growing responsibility |\n| 14-17 | 0.85 | Nearly adult |\n| 18+ | 1.0 | Full responsibility |\n\n### Skill Bonus\n\nWhen a member has a skill relevant to a chore, their effort for that chore is\nreduced by 20% (it's easier for them), but the chore still counts full effort\nfor fairness. This naturally assigns skilled members to matching chores while\nkeeping the effort ledger fair.\n\n### Recency Penalty\n\nFor the most unpleasant chores (effort 4-5), whoever did it last gets a\n+0.5 weight against being assigned again. This prevents one person from\nalways getting the worst tasks.\n\n## Assignment Algorithm\n\n```\n1. Calculate each member's cumulative effort deficit/surplus\n2. Sort members by deficit (most behind gets priority)\n3. For each chore (sorted by effort, highest first):\n a. Filter members who have the required skills (if any)\n b. Filter by age appropriateness\n c. Apply recency penalty for unpleasant chores\n d. Assign to the eligible member with the highest deficit\n4. Log assignments and update fairness ledger\n```\n\n## Compliance Tracking\n\nCompleted chores add to a member's effort ledger. Skipped chores don't.\nOver time:\n\n- **Effort surplus** โ†’ Member doing more than their share โ†’ Praise them\n- **Effort deficit** โ†’ Member doing less โ†’ Address gently\n- **Consistent skipper** โ†’ Pattern detection โ†’ Flag for family discussion\n\n## Edge Cases\n\n- **Guests/visitors**: Not assigned chores\n- **Illness**: Member can be marked unavailable (`set-available false`)\n- **Vacation**: Chores redistributed during absence\n- **New chore**: Automatically weighted and added to next rotation\n\nFile v0.1.0:skill-card.md\n\n## Description:\n\nSmart chore assignment for families and households that assigns tasks based on skills, schedule, and fairness scoring, tracks who did what, rotates unpleasant tasks equitably, and generates visual chore charts and fairness reports.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[voronindenis5](https://clawhub.ai/user/voronindenis5)\n\n### License/Terms of Use:\n\nMIT\n\n## Use Case:\n\nHousehold members or agents assisting them use this skill to configure a local chore wheel, generate weekly assignments, track completion, and produce fairness reports for family or shared-home chores.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The local chore database can contain household names, ages, skills, assignments, and skip reasons in plaintext.\n\nMitigation: Use non-sensitive names where practical, protect the local user account, and delete or back up ~/.chore_wheel.json according to household privacy needs.\n\nRisk: Age-based chore suggestions may not account for every child's maturity, supervision needs, or hazards involving cooking, tools, chemicals, pets, or childcare.\n\nMitigation: Have an adult review and adjust assignments before acting on safety-sensitive chores.\n\n## Reference(s):\n\n- [Fairness Algorithm](references/fairness-algorithm.md)\n- [Age-Appropriate Chores](references/age-chores.md)\n- [Server-Resolved GitHub Repository](https://github.com/voronindenis5/chore-wheel-genius)\n- [ClawHub Skill Page](https://clawhub.ai/voronindenis5/skills/chore-wheel-genius)\n\n## Skill Output:\n\n**Output Type(s):** [Shell commands, Text, Markdown, Configuration guidance]\n\n**Output Format:** [Markdown with inline shell commands and CLI text output]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [May create or update a local JSON chore database at ~/.chore_wheel.json when its commands are executed.]\n\n## Skill Version(s):\n\n0.1.0 (source: ClawHub release metadata; artifact frontmatter states 1.0.0)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nFile v0.1.0:LICENSE\n\nMIT License\n\nCopyright (c) 2026 Denis Voronin\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.","readmeExcerpt":"Skill: chore-wheel-genius Owner: voronindenis5 Summary: 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. Tags: latest:0.1.0 Version history: v0.1.0 | 2026-08-14T06:17:45.453Z | auto Initial release of Chore Wheel Genius.","codeSnippets":[],"executableExamples":[{"language":"bash","snippet":"# Add household members\npython3 scripts/chore_wheel.py add-member Mom --skills cooking,laundry\npython3 scripts/chore_wheel.py add-member Dad --skills repair,cooking\npython3 scripts/chore_wheel.py add-member Alice 14\npython3 scripts/chore_wheel.py add-member Bob 10\n\n# Define chores\npython3 scripts/chore_wheel.py add-chore \"Cook dinner\" --effort 5 --freq daily --skills cooking\npython3 scripts/chore_wheel.py add-chore \"Take out trash\" --effort 2 --freq daily\npython3 scripts/chore_wheel.py add-chore \"Clean bathroom\" --effort 4 --freq weekly\n\n# Generate this week's assignments\npython3 scripts/chore_wheel.py assign\n\n# Mark chores as done\npython3 scripts/chore_wheel.py done Mom \"Cook dinner\"\n\n# Check fairness\npython3 scripts/chore_wheel.py fairness\n\n# Weekly report\npython3 scripts/chore_wheel.py report"},{"language":"bash","snippet":"# Set up household\npython3 scripts/chore_wheel.py add-member Mom --skills cooking,laundry\npython3 scripts/chore_wheel.py add-member Dad --skills repair,cooking\npython3 scripts/chore_wheel.py add-member Alice 14\npython3 scripts/chore_wheel.py add-member Bob 10\n\n# Define chores\npython3 scripts/chore_wheel.py add-chore \"Cook dinner\" --effort 5 --freq daily --skills cooking\npython3 scripts/chore_wheel.py add-chore \"Take out trash\" --effort 2 --freq daily\npython3 scripts/chore_wheel.py add-chore \"Clean bathroom\" --effort 4 --freq weekly\n\n# Generate assignments\npython3 scripts/chore_wheel.py assign\n\n# Track completion\npython3 scripts/chore_wheel.py done Alice \"Take out trash\"\n\n# Check fairness\npython3 scripts/chore_wheel.py fairness"},{"language":"python","snippet":"AGE_EFFORT_CAP = {\n range(2, 4): 1, # Only effort-1 chores\n range(4, 6): 2, # Up to effort-2\n range(6, 8): 2,\n range(8, 11): 3, # Up to effort-3\n range(11, 14): 4, # Up to effort-4\n range(14, 200): 5, # All chores\n}\n\nAGE_EFFORT_MULTIPLIER = {\n range(0, 6): 0.0,\n range(6, 8): 0.3,\n range(8, 11): 0.5,\n range(11, 14): 0.7,\n range(14, 18): 0.85,\n range(18, 200): 1.0,\n}"},{"language":"text","snippet":"target = total_chore_effort / N ร— age_multiplier"},{"language":"text","snippet":"1. Calculate each member's cumulative effort deficit/surplus\n2. Sort members by deficit (most behind gets priority)\n3. For each chore (sorted by effort, highest first):\n a. Filter members who have the required skills (if any)\n b. Filter by age appropriateness\n c. Apply recency penalty for unpleasant chores\n d. Assign to the eligible member with the highest deficit\n4. Log assignments and update fairness ledger"}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\nname: chore-wheel-genius\nversion: 1.0.0\nauthor: Denis Voronin\nlicense: MIT\ndescription: >\n Smart chore assignment for families and households. Assigns tasks based on\n skills, schedule, and fairness scoring. Tracks who did what, detects\n freeloaders, rotates unpleasant tasks equitably, and generates visual\n chore charts and fairness reports.\ntags:\n - household\n - chores\n - family\n - fairness\n - scheduling\n---\n\n# Chore Wheel Genius\n\nA standalone command-line tool for assigning household chores fairly across\nfamily members. Instead of random rotation or nagging, this system considers\neach person's skills, availability, chore history, and fairness score to\ngenerate optimal weekly chore assignments.\n\n## Quick Start\n\n```bash\n# Add household members\npython3 scripts/chore_wheel.py add-member Mom --skills cooking,laundry\npython3 scripts/chore_wheel.py add-member Dad --skills repair,cooking\npython3 scripts/chore_wheel.py add-member Alice 14\npython3 scripts/chore_wheel.py add-member Bob 10\n\n# Define chores\npython3 scripts/chore_wheel.py add-chore \"Cook dinner\" --effort 5 --freq daily --skills cooking\npython3 scripts/chore_wheel.py add-chore \"Take out trash\" --effort 2 --freq daily\npython3 scripts/chore_wheel.py add-chore \"Clean bathroom\" --effort 4 --freq weekly\n\n# Generate this week's assignments\npython3 scripts/chore_wheel.py assign\n\n# Mark chores as done\npython3 scripts/chore_wheel.py done Mom \"Cook dinner\"\n\n# Check fairness\npython3 scripts/chore_wheel.py fairness\n\n# Weekly report\npython3 scripts/chore_wheel.py report\n```\n\n## Commands\n\n| Command | Description |\n|---------|-------------|\n| `add-member [age] [--skills s1,s2]` | Register a household member |\n| `add-chore [--effort 1-5] [--freq daily\\|weekly\\|monthly] [--skills s1,s2]` | Define a chore |\n| `assign [week]` | Generate fair chore assignments |\n| `done ` | Mark a chore as completed |\n| `skip ` | Log a skipped chore |\n| `fairness` | Show fairness score for each member |\n| `report [weeks]` | Generate a multi-week chore report |\n| `chart` | Display this week's visual chore chart |\n| `swap ` | Swap a chore between members |\n| `list-chores` | Show all defined chores |\n| `list-members` | Show all household members |\n| `history [weeks]` | Show a member's chore history |\n\n## How It Works\n\n### Fairness Scoring Algorithm\nEach member has a **fairness score** based on:\n- **Total effort** accumulated over time (weighted by chore difficulty)\n- **Age adjustment** โ€” younger children get lighter loads\n- **Skill matching** โ€” if you're skilled at cooking, you cook more (but not exclusively)\n- **Recency penalty** โ€” whoever did the unpleasant chore last time gets a break\n\n### Effort-Weighted Rotation\nChores are weighted by effort (1-5):\n- Effort 1: Take out trash, water plants\n- Effort 2: Load dishwasher, feed pets\n- Effort 3: Vacuum, mop floors\n- Effort 4: Clean bathroom, deep clean kitchen\n- Effort 5: Cook"},{"path":"README.md","content":"# Chore Wheel Genius ๐Ÿ โœจ\n\nEnd chore wars forever. This tool assigns household tasks fairly based on\nskills, availability, age, and past effort โ€” so nobody feels overworked and\nnobody gets a free ride.\n\n## The Problem\n\nEvery household fights about chores:\n- **\"That's not fair!\"** โ€” someone always feels they do more\n- **\"It's not my turn!\"** โ€” rotation is random or forgotten\n- **\"I always get the gross chores!\"** โ€” unpleasant tasks pile on one person\n- **\"I don't know how to do that.\"** โ€” no skill matching\n- **\"I was busy!\"** โ€” no flexibility for schedules\n- **No accountability** โ€” nobody remembers who actually did what\n\n## The Solution\n\nAn effort-weighted, skill-matched, fairness-optimized chore assignment system:\n\n1. Each member gets chores matched to their skills and age\n2. Total effort is balanced โ€” not just chore count\n3. Unpleasant tasks rotate so nobody is stuck\n4. History tracks who actually did what\n5. Fairness scores reveal who's carrying the load\n\n## Features\n\n- ๐Ÿ‘จโ€๐Ÿ‘ฉโ€๐Ÿ‘งโ€๐Ÿ‘ฆ **Multi-person households** โ€” kids and adults with different capabilities\n- โš–๏ธ **Effort-weighted assignment** โ€” 5 trash runs โ‰  5 bathroom cleans\n- ๐ŸŽฏ **Skill matching** โ€” cooks cook, handypeople fix, everyone learns\n- ๐Ÿ”„ **Unpleasant chore rotation** โ€” nobody always cleans the toilet\n- ๐Ÿ“Š **Fairness scores** โ€” quantitative, not emotional\n- ๐Ÿ“… **Flexible scheduling** โ€” daily, weekly, monthly frequencies\n- ๐Ÿ“ˆ **History tracking** โ€” see trends and who's slacking\n- ๐Ÿ† **Praise detection** โ€” identify the unsung heroes of the household\n- ๐Ÿ“‹ **Visual charts** โ€” printable weekly chore chart\n\n## Quick Start\n\n```bash\n# Set up household\npython3 scripts/chore_wheel.py add-member Mom --skills cooking,laundry\npython3 scripts/chore_wheel.py add-member Dad --skills repair,cooking\npython3 scripts/chore_wheel.py add-member Alice 14\npython3 scripts/chore_wheel.py add-member Bob 10\n\n# Define chores\npython3 scripts/chore_wheel.py add-chore \"Cook dinner\" --effort 5 --freq daily --skills cooking\npython3 scripts/chore_wheel.py add-chore \"Take out trash\" --effort 2 --freq daily\npython3 scripts/chore_wheel.py add-chore \"Clean bathroom\" --effort 4 --freq weekly\n\n# Generate assignments\npython3 scripts/chore_wheel.py assign\n\n# Track completion\npython3 scripts/chore_wheel.py done Alice \"Take out trash\"\n\n# Check fairness\npython3 scripts/chore_wheel.py fairness\n```\n\n## Requirements\n\n- Python 3.6+ (stdlib only)\n\n## License\n\nMIT ยฉ Denis Voronin"},{"path":"_meta.json","content":"{\n \"ownerId\": \"kn75wwn4x6djaf28jbykeamazd81gtdp\",\n \"slug\": \"chore-wheel-genius\",\n \"version\": \"0.1.0\",\n \"publishedAt\": 1786688265453\n}"},{"path":"references/age-chores.md","content":"# Age-Appropriate Chores\n\n## Developmental Chore Guide\n\n### Ages 2-3\n**Capabilities:** Imitation, simple one-step tasks\n- Pick up toys\n- Put clothes in hamper\n- Wipe up spills (with help)\n- Feed pets (with supervision)\n\n### Ages 4-5\n**Capabilities:** Following simple instructions, desire to \"help\"\n- Make bed (loosely)\n- Set napkins/silverware on table\n- Water plants\n- Sort socks in laundry\n- Dust low surfaces\n- Clear own plate\n\n### Ages 6-7\n**Capabilities:** More independence, simple routines\n- Make bed properly\n- Fold and put away own clothes\n- Set the table\n- Sweep small areas\n- Pack own school bag\n- Feed pets independently\n- Weed garden (with direction)\n\n### Ages 8-10\n**Capabilities:** Multi-step tasks, following checklists\n- Load/unload dishwasher\n- Vacuum\n- Take out trash\n- Clean own bedroom thoroughly\n- Help with cooking (simple tasks)\n- Fold laundry\n- Wipe down counters\n- Clean sinks\n\n### Ages 11-13\n**Capabilities:** Nearly independent, can manage own checklist\n- Cook simple meals (eggs, pasta, sandwiches)\n- Do own laundry completely\n- Clean bathroom (sink, toilet, mirror)\n- Mop floors\n- Grocery shopping (with list)\n- Wash the car\n- Change bed sheets\n- Take pets for walks\n\n### Ages 14-17\n**Capabilities:** Full chore competence, can handle any household task\n- Cook full family meals\n- Deep clean any room\n- Yard work (mowing, raking)\n- Minor home repairs\n- Manage household budget for groceries\n- Babysit younger siblings\n- Handle trash/recycling completely\n\n## Why Age-Appropriate Chores Matter\n\n1. **Building competence**: Children learn life skills gradually\n2. **Confidence**: Success at appropriately challenging tasks builds self-esteem\n3. **Family contribution**: Everyone contributes according to ability\n4. **Independence**: Chore skills transfer to adult life\n\n## Implementation in This Tool\n\n```python\nAGE_EFFORT_CAP = {\n range(2, 4): 1, # Only effort-1 chores\n range(4, 6): 2, # Up to effort-2\n range(6, 8): 2,\n range(8, 11): 3, # Up to effort-3\n range(11, 14): 4, # Up to effort-4\n range(14, 200): 5, # All chores\n}\n\nAGE_EFFORT_MULTIPLIER = {\n range(0, 6): 0.0,\n range(6, 8): 0.3,\n range(8, 11): 0.5,\n range(11, 14): 0.7,\n range(14, 18): 0.85,\n range(18, 200): 1.0,\n}\n```\n\n## Sources\n\n- American Academy of Pediatrics (AAP) child development guidelines\n- Montessori practical life curriculum\n- CDC developmental milestones"},{"path":"references/fairness-algorithm.md","content":"# Fairness Algorithm\n\n## Core Principle\n\nFairness in a household is not about doing the same *number* of chores โ€” it's\nabout contributing the same *amount of effort* adjusted for age and ability.\n\n## Effort Scoring\n\nEach chore has an effort score (1-5):\n\n| Effort | Description | Examples |\n|--------|-------------|----------|\n| 1 | Minimal | Water plants, feed pet, sort mail |\n| 2 | Light | Take out trash, load dishwasher, dust |\n| 3 | Moderate | Vacuum, mop, grocery shopping |\n| 4 | Heavy | Clean bathroom, deep clean kitchen, yard work |\n| 5 | Very Heavy | Cook full meal, major repair, move furniture |\n\n## Fairness Calculation\n\n### Per-Member Effort Target\n\nFor a household of N members, the weekly effort target per member is:\n\n```\ntarget = total_chore_effort / N ร— age_multiplier\n```\n\n### Age Multipliers\n\n| Age | Multiplier | Rationale |\n|------|-----------|-----------|\n| < 6 | 0.0 | Too young for chores |\n| 6-7 | 0.3 | Light participation |\n| 8-10 | 0.5 | Half the adult load |\n| 11-13 | 0.7 | Growing responsibility |\n| 14-17 | 0.85 | Nearly adult |\n| 18+ | 1.0 | Full responsibility |\n\n### Skill Bonus\n\nWhen a member has a skill relevant to a chore, their effort for that chore is\nreduced by 20% (it's easier for them), but the chore still counts full effort\nfor fairness. This naturally assigns skilled members to matching chores while\nkeeping the effort ledger fair.\n\n### Recency Penalty\n\nFor the most unpleasant chores (effort 4-5), whoever did it last gets a\n+0.5 weight against being assigned again. This prevents one person from\nalways getting the worst tasks.\n\n## Assignment Algorithm\n\n```\n1. Calculate each member's cumulative effort deficit/surplus\n2. Sort members by deficit (most behind gets priority)\n3. For each chore (sorted by effort, highest first):\n a. Filter members who have the required skills (if any)\n b. Filter by age appropriateness\n c. Apply recency penalty for unpleasant chores\n d. Assign to the eligible member with the highest deficit\n4. Log assignments and update fairness ledger\n```\n\n## Compliance Tracking\n\nCompleted chores add to a member's effort ledger. Skipped chores don't.\nOver time:\n\n- **Effort surplus** โ†’ Member doing more than their share โ†’ Praise them\n- **Effort deficit** โ†’ Member doing less โ†’ Address gently\n- **Consistent skipper** โ†’ Pattern detection โ†’ Flag for family discussion\n\n## Edge Cases\n\n- **Guests/visitors**: Not assigned chores\n- **Illness**: Member can be marked unavailable (`set-available false`)\n- **Vacation**: Chores redistributed during absence\n- **New chore**: Automatically weighted and added to next rotation"}],"languages":[],"docsSourceLabel":"CLAWHUB","editorialOverview":"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. Skill: chore-wheel-genius Owner: voronindenis5 Summary: 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. Tags: latest:0.1.0 Version history: v0.1.0 | 2026-08-14T06:17:45.453Z | auto Initial release of Chore Wheel Genius.","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":1481,"uniquenessScore":50,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-10T06:45:54.440Z","emptyReason":"No screenshots, media assets, or demo links are available."},"primaryImageUrl":null,"mediaAssetCount":0,"assets":[],"demoUrl":null},"ownerResources":{"evidence":{"source":"unclaimed","verified":false,"confidence":"low","updatedAt":"2026-10-10T06:45:54.440Z","emptyReason":"This page has not been claimed by the agent owner."},"hasCustomPage":false,"customPageUpdatedAt":null,"customLinks":[],"structuredLinks":{"docsUrl":null,"demoUrl":null,"supportUrl":null,"pricingUrl":null,"statusUrl":null},"customPage":null},"relatedAgents":{"evidence":{"source":"protocol-neighbors","verified":false,"confidence":"medium","updatedAt":"2026-10-10T10:45:01.094Z","emptyReason":null},"items":[{"id":"8ebccd8e-3863-4187-8355-c3f14e1f9edf","entityType":"agent","canonicalPath":"/agent/iofficeai-aionui","slug":"iofficeai-aionui","name":"AionUi","description":"Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | ๐ŸŒŸ Star if you like it!","url":"https://github.com/iOfficeAI/AionUi","homepage":"https://www.aionui.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-10-09T19:11:12.944Z","createdAt":"2026-02-25T03:38:16.584Z","downloads":null},{"id":"b917f68a-ebff-438e-84f8-3f4b2494c0bc","entityType":"agent","canonicalPath":"/agent/activepieces-activepieces","slug":"activepieces-activepieces","name":"activepieces","description":"AI Agents & MCPs & AI Workflow Automation โ€ข (~400 MCP servers for AI agents) โ€ข AI Automation / AI Agent with MCPs โ€ข AI Workflows & AI Agents โ€ข MCPs for AI Agents","url":"https://github.com/activepieces/activepieces","homepage":"https://www.activepieces.com","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-15T02:22:12.426Z","createdAt":"2026-02-25T03:38:12.412Z","downloads":null},{"id":"5cb26759-3a39-483f-94cf-276a98c13bb8","entityType":"agent","canonicalPath":"/agent/cherryhq-cherry-studio","slug":"cherryhq-cherry-studio","name":"cherry-studio","description":"AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs","url":"https://github.com/CherryHQ/cherry-studio","homepage":"https://cherry-ai.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-11T14:38:40.986Z","createdAt":"2026-02-25T03:38:19.379Z","downloads":null},{"id":"6f6582d0-5d76-4f0f-b81d-86520247950b","entityType":"agent","canonicalPath":"/agent/copilotkit-copilotkit","slug":"copilotkit-copilotkit","name":"CopilotKit","description":"The Frontend for Agents & Generative UI. React + Angular","url":"https://github.com/CopilotKit/CopilotKit","homepage":"https://docs.copilotkit.ai","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-03-25T09:50:57.846Z","createdAt":"2026-02-25T03:39:14.617Z","downloads":null}],"links":{"hub":"/agent","source":"/agent/source/clawhub","protocols":[{"label":"OpenClaw","href":"/agent/protocol/openclew"}]}}}