Help us improve
Share bugs, ideas, or general feedback.
From ha-nova
Use when creating, updating, or deleting Home Assistant automations or scripts through HA NOVA Relay. Self-contained — resolves entities and reviews internally.
npx claudepluginhub markusleben/ha-nova --plugin ha-novaHow this skill is triggered — by the user, by Claude, or both
Slash command
/ha-nova:writeThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Mutations only:
Use when analyzing, reviewing, auditing, or checking Home Assistant automations, scripts, or helpers for errors, best-practice violations, and conflicts. Do not invoke `ha-nova:read` separately — this skill handles discovery and reading internally.
Provides best practices for Home Assistant automations, helpers, scripts, and dashboards. Guides on avoiding templates, using native constructs, and safe refactoring.
Creates and manages Home Assistant automations including rules, triggers, conditions, actions, scripts, scenes, and blueprints. Covers device triggers and conditional logic.
Share bugs, ideas, or general feedback.
Mutations only:
automation, scriptcreate, update, deleteVerify relay CLI:
ha-nova relay health
If this fails, run onboarding: ha-nova setup.
skills/ha-nova/agents/resolve-agent.md.target_id, current_config, bp_status, suggested_enhancements.
entity_id -> unique_id via registry firstcreate IDs: automations=Unix timestamp, scripts=slug.delete):
suggested_enhancements from resolve-agent (max 4, numbered). User accepts by number or "skip" → merge accepted into config BEFORE preview. Skip when SUGGESTED_ENHANCEMENTS: none or already present on update.skills/review/SKILL.md Step 1 plus skills/review/checks.md. Run S/R/P/M checks analytically on the draft YAML — no relay calls (scripts: F-01..F-08; helper references: H-01..H-08. Defer H-09/H-10 to Phase 4 for live evidence).
Use exactly one explicit pre-write verdict line before apply:
trigger.id check into an explicit elif. Or refactor to choose + condition: trigger. Advisory only: do not block the write and do not require extra confirmation.
Track findings by check type for dedup in Phase 4, except for the R-18 follow-up below.confirm:<token> (exact token only; see context skill → Safety Baseline).skills/ha-nova/agents/apply-agent.md.Fallback: If agent dispatch unavailable, execute inline.
Do NOT invoke ha-nova:review separately.
target_id (do NOT re-resolve by slug):
ha-nova relay core --method GET --path /api/config/automation/config/<target_id> --jq-file <filter-file> --out <result-file>/api/config/script/config/<target_id><filter-file>:
if .ok then .data.body else error("relay error: \(.error.message // "unknown")") end
entity_id from entity registry by matching unique_id == <target_id>, then read /api/states/{entity_id} to confirm runtime presenceentity_id differs, report it and point to skills/ha-nova/safe-refactoring.md; do not silently assume the requested slug wonid,unique_id,created_at,modified_at,editor,enabled).trigger→triggers, action→actions, condition→conditions). Account for plural aliasing when comparing — these are not real diffs.review/SKILL.md Step 1. If they match, skip the normal subset as "covered in pre-write review," but still re-run the storage-sensitive R-18 subset against the persisted read-back config.R-19 follows normal dedup. If the user already saw the pre-write warning, do not repeat it after the write unless it becomes a new distinct finding category.<payload-file> with {"type":"search/related","item_type":"entity","item_id":"<entity_id>"}, run ha-nova relay ws --data-file <payload-file>, read max 3 related configs.skills/ha-nova/SKILL.md → Output Localization):
Questions to consider, Suggestions, or Instant help in post-write mode.See skills/ha-nova/SKILL.md → Response Format.
## Post-Write Review section. Skipping it is a skill violation.get_states — use targeted registry/config readsskills/ha-nova/relay-api.md, skills/ha-nova/payload-schemas.md, skills/ha-nova/best-practices.md, skills/ha-nova/automation-patterns.md, skills/ha-nova/template-guidelines.md, skills/ha-nova/safe-refactoring.mdskills/ha-nova/agents/resolve-agent.md, skills/ha-nova/agents/apply-agent.mdskills/review/SKILL.md, skills/review/checks.md, docs/reference/skill-architecture.md