bishwashere/skills/home-assistant

Home Assistant

Control and query your Home Assistant instance with simple commands. You do not need to say "entities", "domain", or "state"-use the command phrases below and the skill will run the right action.

Config: Set HA_TOKEN in ~/.pasture/.env (e.g. via pasture skills install home-assistant). HA_URL is optional and defaults to http://localhost:8123. Add "home-assistant" to skills.enabled in config.

How to use

Set arguments.command to one of the commands below. The user can speak naturally; you translate their intent into a single command string.

Commands (use arguments.command)

| Command | When to use | Example | |---------|-------------|---------| | list sensor | List temperature/humidity and other sensors | "Check all temp sensors" → list sensor | | list lights | List all lights | "What lights do I have?", "Show my lights" | | list automation | List all automations | "List my automations", "Show thermostat automations" | | list switch | List switches | "What switches are there?" | | list | List all entities | "List all devices" | | search <word> | Find home devices/appliances/sensors by name | "Find kitchen lights" → search kitchen; "dining room sensor" → search dining | | state <entity_id> | Get current state/reading of a home device or sensor | "Is the living room light on?" → state light.living_room | | on <entity_id> | Turn on a light/switch | "Turn on the living room light" → on light.living_room | | on <entity_id> <0-255> | Turn on with brightness | "Set kitchen light to 50%" → on light.kitchen 128 | | off <entity_id> | Turn off | "Turn off the bedroom light" → off light.bedroom | | toggle <entity_id> | Toggle on/off | "Toggle the fan" → toggle switch.fan | | scene <entity_id> | Activate a scene | "Movie mode" → scene scene.movie_night | | script <entity_id> | Run a script | "Run good night script" → script script.good_night | | automation <entity_id> | Trigger an automation | "Run my morning automation" → automation automation.morning | | climate <entity_id> <temp> | Set thermostat | "Set thermostat to 22" → climate climate.thermostat 22 | | help | List all commands | When the user asks how to use Home Assistant |

User says → command (translate intent)

| User says | Use command | |-----------|-------------| | List my lights / What lights do I have? | list lights | | Show my automations | list automation | | Find a device or appliance by name | search <name> | | Turn on the living room light | on light.living_room | | Turn off the bedroom light | off light.bedroom | | Is the garage door open? | state cover.garage_door | | What are my home sensors reading? | list sensor or search <sensor name> then state <entity_id> | | Run my "good night" script | script script.good_night | | Trigger morning automation | automation automation.morning | | Set thermostat to 21 | climate climate.thermostat 21 | | Anything about outdoor / weather | Do NOT use this skill - use web search instead |

Finding entity IDs

If the user mentions a room or device by name and you don't know the entity_id:

1. Use search <name> (e.g. search living_room) to get matching entities and their entity_id.
2. Then use on, off, state, etc. with that entity_id.

How to present results to the user

Always reply in natural, conversational language. The tool result includes a summary field — use that as your source of truth.

• Say: "It's 72° and sunny outside, and about 74° in the dining room."
• Do not show entity_id values (e.g. sensor.dining_room_temperature, weather.forecast_home).
• Do not repeat the same reading twice in different formats.
• Do not use bullet lists or labeled sections unless the user asked for a list of devices.
• Round temperatures to whole degrees when speaking (73.58° → "about 74°").
• Use friendly names (Dining Room, Outside) — never raw Home Assistant identifiers.

Notes

• Entity IDs are domain.name (e.g. light.living_room, automation.morning). Use list or search to discover them.
• For raw API calls use: call <domain> <service> [entity_id] (advanced).

Tool schema

home_assistant_run
  description: Control and query home appliances and sensors inside the home (lights, switches, plugs, fans, thermostats, home sensors, automations, scenes, scripts). Use command string e.g. "list lights", "on light.xyz", "search kitchen", "state light.living_room". Reply to the user in plain conversational sentences using the summary field — never entity_id. Do NOT use for outdoor or weather queries unless weather is exposed in Home Assistant.
  parameters:
    command: string