mcpField
H
home-assistant-automation-scripts

home-assistant-automation-scripts

github.com/bradsjmOther46782 installsUpdated 16w ago
Repository

About home-assistant-automation-scripts

A skill for working with Home Assistant automations and scripts, covering entity and service discovery, configuration authoring, template validation, and troubleshooting. It maps these tasks to ha-mcp tools for inspecting and changing automations, scripts, and related configuration.

Key features

  1. 01Discover entities and services
  2. 02Inspect and search existing configuration
  3. 03Create or update automations and scripts
  4. 04Validate templates and troubleshoot execution traces
  5. 05Import blueprints and inspect history data

Use cases

  1. 01Draft automations based on an instance's entities and services
  2. 02Modify or refactor existing script configuration
  3. 03Validate templates and investigate automation run issues

MCP support

Uses Home Assistant tools through ha-mcp for entity and service discovery, configuration reads and writes, template validation, and run troubleshooting.

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/bradsjm/hassio-addons --skill home-assistant-automation-scripts

After installing, type/home-assistant-automation-scriptsin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

references/
DEBUG_WORKFLOWS.md
LIMITED_TEMPLATES.md
REFERENCE.md
TEMPLATE_ENTITY_GUIDE.md

Details

From the project README

Home Assistant Automations & Scripts

Workflow

  • Determine whether the request is instance-specific or general syntax.
  • Discover entities and services before drafting config.
  • When decisions involve templates, helpers, automation modes, entity/device IDs, or refactoring existing config, follow home-assistant-best-practices and its references.
  • Provide minimal, valid YAML/JSON or tool-driven changes.
  • Validate templates and troubleshoot with traces and logs.

Tooling map (ha-mcp)

  • Discover entities: ha_get_overview, ha_search_entities
  • Discover services: ha_list_services
  • Inspect existing: ha_config_get_automation, ha_config_get_script, ha_deep_search
  • Create/update automation: ha_config_set_automation
  • Create/update script: ha_config_set_script
  • Blueprints: ha_get_blueprint, ha_import_blueprint
  • Validate templates: ha_eval_template
  • Troubleshoot runs: ha_get_automation_traces, ha_get_logbook
  • History/trends: ha_get_history, ha_get_statistics

References

All reference files are relative to the location of this SKILL.md file.

  • Best practices: home-assistant-best-practices (see its references/automation-patterns.md, references/template-guidelines.md, references/helper-selection.md, references/device-control.md, references/safe-refactoring.md)
  • Limited templates: references/LIMITED_TEMPLATES.md
  • Debug workflows: references/DEBUG_WORKFLOWS.md
  • Template entities: references/TEMPLATE_ENTITY_GUIDE.md
  • Additional notes: references/REFERENCE.md

Comments

Markdown supported