ha-ultimate_skill

Overview

This skill provides definitive Home Assistant control for AI agents using the Home Assistant REST API. It covers 25+ entity domains with safety enforcement, inventory awareness, webhooks, and a full CLI wrapper for common tasks. Use it to inspect, automate, and safely execute actions across lights, climate, locks, covers, media, sensors, scripts, automations, and more.

How this skill works

The skill connects to Home Assistant via a configured HA_URL and long-lived HA_TOKEN, exposing REST calls and a CLI wrapper for discovery and control. It can generate a full entity inventory, call services for domain-specific actions, and enforce layered safety rules (confirmation, critical-action workflow, and optional blocked-entities). Webhooks and a CLI make integration and scripting straightforward.

When to use it

• Query or map all Home Assistant entities and areas before automating.
• Perform standard device operations: lights, switches, climate, media, fans, vacuums.
• Safely control sensitive devices like locks, alarm panels, garage doors, and covers.
• Trigger or manage automations, scenes, and scripts programmatically.
• Integrate Home Assistant into agent workflows, webhooks, or CI tooling.

Best practices

• Run the entity inventory once and read ENTITIES.md to avoid acting on unknown devices.
• Store HA_URL and HA_TOKEN securely (environment variables or a protected .env file).
• Respect the layered safety flow: prompt users before any security-sensitive action.
• Use blocked_entities.json for permanently disallowed devices you never want automated.
• Prefer IP addresses or secure tunnels for containerized agents to avoid mDNS resolution issues.

Example use cases

• Turn on living room lights with color/brightness and smooth transition for movie mode.
• Set thermostat temperature or HVAC/preset modes from an agent-driven schedule.
• Confirm and open a garage door only after explicit user confirmation using the critical-action workflow.
• Run a bedtime script that dims lights, locks doors, and triggers a sleep scene.
• Trigger automations or call any HA service via the CLI wrapper for remote diagnostics.