---
name: home-maintenance-calendar
description: Use when the user asks what home or car upkeep is due, wants a home maintenance schedule or checklist, asks when to change the furnace filter, test smoke alarms, clean gutters or service the car, or when a scheduled monthly home-maintenance routine runs. Builds a recurring and seasonal task list from the home type, climate and what they own, and sends a monthly checklist of what's due. Read-only; adds calendar reminders only when the user approves.
metadata:
  id: home-maintenance-calendar
  version: "1.0.0"
  author: BotPlaza
---

# Home Maintenance Calendar

> The small jobs that save big repairs, on the month they're due.

## What it does

Keeps the boring-but-important jobs from slipping: furnace filters, smoke alarm tests, gutters before the rain, the water heater flush, the car's next service. Once a month you get a short checklist of what's due, why it matters and roughly how long each job takes.

## When to use

- "What home maintenance is due?", "when should I change the filter?", "make me a home maintenance schedule", "I did the gutters".
- A scheduled routine (default: the 1st of every month at 9:00 AM).

## Requires

Nothing to start: the home profile lives in the assistant's memory. Optional: web access for climate and manufacturer intervals, and a connected calendar if the user wants reminders added.

## Schedule

Default: Monthly, the 1st at 9:00 AM. Run it from a routine or scheduled task at that time; the user can change the time in the routine, not in this skill.

## Inputs

| Field | Default | Notes |
|---|---|---|
| `home_type` | ask | House, townhouse, condo or apartment. Renters get only the tasks a tenant usually handles. |
| `climate` | from city | Cold winters, hot summers, humid, dry, wildfire or hurricane area. Drives the seasonal tasks. |
| `systems` | ask | Furnace, central AC, heat pump, water heater (tank or tankless), well, septic, sump pump, fireplace, sprinklers, pool. |
| `vehicles` | none | Make, model, year and current mileage, for service intervals. |
| `extras` | none | Pets, a deck, a garden, gutters, a yard. |
| `level` | DIY-friendly | Include pro jobs (chimney sweep, HVAC tune-up) as "book a pro" items. |
| `calendar_reminders` | off | When on, offer to add each due task to the calendar, after the user approves. |

Keep a log per task: interval, last done date, and next due date.

## Steps

1. **Build the profile once.** Ask the setup questions in one short message. Look up the typical climate for the user's city.
2. **Build the task list.** Combine recurring tasks (furnace filter every 1–3 months, smoke and CO alarm test monthly, batteries yearly), seasonal tasks for the climate (gutters in late fall and spring, winterize outdoor taps before the first freeze, AC check before summer), and system and vehicle intervals from the manufacturer's guidance when known.
3. **Find what's due.** Each month, list tasks due this month plus anything overdue, using the last-done log. Put safety items (alarms, CO detectors, dryer vent) first.
4. **Add the why and the how long.** One line each: why it matters, and roughly how long it takes or whether to book a pro.
5. **Report** in the format below. If calendar reminders are on, offer to add the due items to the calendar and add only the ones the user approves.
6. **Log completions.** When the user says "done {task}", record the date and roll the next due date forward.

## Output format

```markdown
# Home checklist · {Month}
{N} jobs this month · about {total time}

**Safety first**
- [ ] {Task}: {why, one line}. ~{time}

**This month**
- [ ] {Task}: {why}. ~{time} {· book a pro}

**Overdue**
- [ ] {Task}: due {month}, last done {date}.

**Coming up next month:** {task}, {task}.
Reply "done {task}" to log it. Want these on your calendar?
```

## Edge cases

- **Unknown model or interval:** use a common, conservative interval and say it's a general guide.
- **Renter:** skip landlord jobs (roof, furnace service) but suggest reporting problems to the landlord.
- **Severe weather warning nearby:** add a one-line prep note if the user asked for it.
- **User skips a task twice:** ask once whether to drop it from the list.

## Boundaries

Read-only. It never books a contractor or service appointment, buys parts or filters, or contacts anyone. Calendar reminders are added only after the user approves them, and it never edits or deletes other calendar events. General upkeep guidance, not a professional inspection; for gas, electrical or structural problems, call a licensed pro.