ha-backup-platform-addlisted

Augments an existing Home Assistant Custom Integration with one backup-platform surface — pre/post backup hooks or a backup agent — conforming to spec/ha/backup-platform. For hooks it generates backup.py with async_pre_backup/async_post_backup that symmetrically pause and resume stateful operations around a backup; for an agent it generates the agent listing and listener wiring plus a BackupAgent subclass implementing the full upload/download/list/get/delete contract with the mandated error handling; exact signatures live in the body and spec. Disambiguates hooks-vs-agent by integration type before generating. Activate on "add backup hooks", "make my integration backup-aware", "provide a backup agent", or equivalent German requests. Do not activate for greenfield scaffolding (ha-integration-scaffold), the sibling diagnostics module (ha-diagnostics-augment), encryption/retention/restore orchestration (owned by the backup manager), or deploying to a live HA instance.
nolte/claude-home-assistant · ★ 1 · AI & Automation · score 68

Install: claude install-skill nolte/claude-home-assistant

# HA Backup Platform Add Spec: `spec/claude/ha-backup-platform-add/en.md` (EN canonical) / `spec/claude/ha-backup-platform-add/de.md` (DE translation). ## Why this is a skill, not an agent - **Human-visible augmentation surface** — the user describes the integration type and reads back the `backup.py` module and the conformance report; a skill keeps this on the visible command surface, like the sibling augment skills (`ha-config-flow-augment`, `ha-coordinator-add`, `ha-repairs-add`, `ha-device-automation-add`). - **Mid-flow interactivity** — the hooks-vs-agent disambiguation is a per-run dialogue the user approves before generation. - **Bounded, inline generation** — one platform module (the two hook functions, or the agent class plus its registration) fits inline; no isolated agent context is needed. - Counter-dimension considered: the draft→validate loop could be an agent, but the surface decision belongs in the user's working context; skill wins. ## When this skill activates Use this skill to add **one** backup-platform surface — pre/post backup hooks (for DB-writing or stateful integrations) or a backup agent (for storage-providing integrations) — to an existing integration via its `backup.py` platform module. ## When NOT to activate - greenfield integration scaffolding → `ha-integration-scaffold` - the sibling diagnostics platform module → `ha-diagnostics-augment` - backup encryption, retention, scheduling, or restore orchestration → owned by the backup manager /