ha-ai-mcp-server 0.3.8 → 0.3.9

package/dist/cli/skills.d.ts

@@ -0,0 +1,12 @@
+export interface SkillDefinition {
+    name: string;
+    description: string;
+    content: string;
+}
+export declare const EMBEDDED_SKILLS: Record<string, string>;
+export declare function getTargetSkillsDirectories(customDir?: string): string[];
+export declare function syncSkills(customDir?: string, silent?: boolean): {
+    installedCount: number;
+    targetDirs: string[];
+};
+//# sourceMappingURL=skills.d.ts.map

package/dist/cli/skills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../src/cli/skills.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CA6dlD,CAAC;AAEF,wBAAgB,0BAA0B,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CA6BvE;AAED,wBAAgB,UAAU,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,MAAM,UAAQ,GAAG;IAAE,cAAc,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,EAAE,CAAA;CAAE,CAkC/G"}

package/dist/cli/skills.js

@@ -0,0 +1,537 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+import * as os from "node:os";
+export const EMBEDDED_SKILLS = {
+    "ha-device-controller": `---
+name: ha-device-controller
+description: SOP for safely discovering entities, calling Home Assistant services, controlling smart devices, and verifying state transitions.
+---
+
+# Home Assistant Device Controller Skill
+
+## Overview
+
+The \`ha-device-controller\` skill defines the Standard Operating Procedure (SOP) for querying real-time smart device states, invoking Home Assistant domain services (lights, switches, climate, media players, covers), and validating that the target hardware correctly transitions state.
+
+---
+
+## Workflow & Steps
+
+\`\`\`mermaid
+flowchart TD
+    A[Step 1: Discover Entity & Current State] --> B[Step 2: Validate Domain & Payload Schema]
+    B --> C[Step 3: Execute Service Call]
+    C --> D[Step 4: Verify Post-Execution State]
+    D --> E{State Verified?}
+    E -- Yes --> F[Success & Report Confirmation]
+    E -- No --> G[Inspect System Logs & Diagnose]
+\`\`\`
+
+### Step 1: Discover Entity & Current State
+Before sending control commands or invoking services, locate the exact target entity ID and inspect its current attributes.
+- Use \`ha_system_list_entities\` with \`domain_filter\` (e.g. \`light\`, \`switch\`, \`climate\`) or \`search_query\`.
+- Verify the current \`state\` (e.g., \`off\` vs \`on\`), supported color modes, preset modes, or available features.
+
+\`\`\`json
+// Example call: ha_system_list_entities
+{
+  "domain_filter": "light",
+  "search_query": "office"
+}
+\`\`\`
+
+### Step 2: Validate Domain & Payload Schema
+Construct the service invocation payload matching Home Assistant Core service specifications.
+- Common services include:
+  - \`light.turn_on\`, \`light.turn_off\`, \`light.toggle\` (with \`brightness\`, \`rgb_color\`, \`color_temp_kelvin\`)
+  - \`switch.turn_on\`, \`switch.turn_off\`, \`switch.toggle\`
+  - \`climate.set_temperature\`, \`climate.set_hvac_mode\` (with \`temperature\`, \`hvac_mode\`)
+  - \`cover.open_cover\`, \`cover.close_cover\`, \`cover.set_cover_position\`
+  - \`homeassistant.update_entity\`, \`homeassistant.reload_all\`
+
+### Step 3: Execute Service Call
+Invoke the service using \`ha_system_call_service\`.
+- Provide the \`domain\`, \`service\`, and \`service_data\` payload.
+
+\`\`\`json
+// Example call: ha_system_call_service
+{
+  "domain": "light",
+  "service": "turn_on",
+  "service_data": {
+    "entity_id": "light.office_light",
+    "brightness": 200
+  }
+}
+\`\`\`
+
+### Step 4: Verify Post-Execution State
+Confirm that the physical device or software entity acknowledged the command and changed state.
+- Re-query \`ha_system_list_entities\` with \`search_query\` targeting the entity.
+- Compare \`last_changed\` and \`state\` against expected outcome.
+- If the entity remains unchanged or reports \`unavailable\`, tail recent logs with \`ha_system_get_logs\` to diagnose integration communication errors.
+
+---
+
+## Tool Reference
+
+| Tool | Purpose | Key Parameters |
+| :--- | :--- | :--- |
+| \`ha_system_list_entities\` | Discover entities and inspect live states | \`domain_filter\`, \`search_query\` |
+| \`ha_system_call_service\` | Call any Home Assistant domain service | \`domain\`, \`service\`, \`service_data\` |
+| \`ha_system_get_logs\` | Inspect system error logs on failures | \`lines_count\`, \`source\` |
+| \`ha_system_health\` | Verify API and integration connectivity | *(none)* |
+
+---
+
+## Safety Rules & Best Practices
+
+1. **Verify Before Execution**: Always confirm entity identity with \`ha_system_list_entities\` before triggering destructive or high-energy actions (heaters, locks, garage doors).
+2. **Post-State Validation**: Never assume a service call succeeded solely based on HTTP 200; verify the entity \`state\` afterwards.
+3. **Graceful Error Handling**: If a device fails to respond, inspect \`ha_system_get_logs\` for Zigbee/Z-Wave/Wi-Fi timeout errors before retrying in a loop.
+`,
+    "ha-dashboard-designer": `---
+name: ha-dashboard-designer
+description: SOP for creating, previewing, and visually iterating Home Assistant Lovelace dashboards using MCP tools and Playwright screenshots.
+---
+
+# Home Assistant Dashboard Designer Skill
+
+## Overview
+
+The \`ha-dashboard-designer\` skill provides a complete Standard Operating Procedure (SOP) for creating, modifying, and polishing Home Assistant Lovelace dashboards with AI-driven visual validation. By combining entity discovery, configuration management with automatic snapshot safety, and headless Playwright screenshot rendering, this skill ensures dashboards are aesthetically refined, responsive across devices, and functional.
+
+---
+
+## Workflow & Steps
+
+\`\`\`mermaid
+flowchart TD
+    A[Step 1: Discover Entities] --> B[Step 2: Inspect Dashboard Config]
+    B --> C[Step 3: Propose Layout & Cards]
+    C --> D[Step 4: Save Lovelace YAML]
+    D --> E[Step 5: Capture Screenshots]
+    E --> F{Step 6: Visual Inspection Loop}
+    F -- Issues Found --> C
+    F -- Approved --> G[Finalize & Present]
+\`\`\`
+
+### Step 1: Query Available Entities
+Before designing or modifying any dashboard cards, discover the available entities, their domains, states, friendly names, and device classes.
+- Use \`ha_system_list_entities\` with domain filters (e.g. \`light\`, \`climate\`, \`sensor\`, \`switch\`, \`media_player\`) or search terms.
+- Verify entity availability and state types (e.g. numeric sensors, binary on/off states, list attributes).
+
+\`\`\`json
+// Example call: ha_system_list_entities
+{
+  "domain_filter": "climate",
+  "search_query": "living_room"
+}
+\`\`\`
+
+### Step 2: Inspect Existing Dashboard Configuration
+Inspect the current dashboard configuration to maintain theme consistency, title naming conventions, badge configurations, and view hierarchy.
+- Use \`ha_dashboard_get_config\` with the target \`dashboard_slug\` (e.g. \`lovelace\` for default or custom slugs like \`dashboard-energy\`).
+- Analyze existing views, card types, custom themes, and column layouts.
+
+\`\`\`json
+// Example call: ha_dashboard_get_config
+{
+  "dashboard_slug": "lovelace"
+}
+\`\`\`
+
+### Step 3: Propose Card Layout & Design
+Design card layouts tailored to the user requirements and device constraints:
+- **Card Selection**:
+  - **Tile Card**: Modern HA standard for lights, switches, media players with feature controls.
+  - **Mushroom Cards**: Minimalist, touch-friendly UI for room summaries, chips, and climate.
+  - **Grid & Stacks**: \`grid\`, \`horizontal-stack\`, and \`vertical-stack\` for structured alignment.
+  - **Glance & Entities**: Compact summaries for sensors (temperatures, battery levels).
+  - **ApexCharts & Gauges**: Historical trends, energy metrics, and analog gauges.
+  - **Conditional Cards**: Dynamic cards that appear only when specific states match (e.g. doors open, low battery).
+- **Responsive Guidelines**:
+  - Use 2-4 columns on desktop layouts.
+  - Ensure single-column or wrapping behavior on mobile screens.
+  - Group cards logically by room or domain.
+
+### Step 4: Save Lovelace YAML Configuration
+Apply the updated dashboard configuration safely.
+- Use \`ha_dashboard_save_config\` supplying the YAML configuration, target \`dashboard_slug\`, and a descriptive \`label\`.
+- Note: \`ha_dashboard_save_config\` automatically creates a safety snapshot before applying modifications and performs YAML schema validation.
+
+\`\`\`json
+// Example call: ha_dashboard_save_config
+{
+  "dashboard_slug": "lovelace",
+  "label": "Add living room climate tile and energy gauge",
+  "config_yaml": "title: Home\\nviews:\\n  - title: Main\\n    path: main\\n    cards:\\n      - type: tile\\n        entity: light.living_room\\n"
+}
+\`\`\`
+
+### Step 5: Capture Rendered Screenshots
+Verify the visual rendering of the updated dashboard using the headless Playwright browser.
+- Use \`ha_dashboard_render_screenshot\` with the target \`url_path\` (e.g. \`lovelace/0\`, \`dashboard-energy\`).
+- Always test across multiple device presets:
+  - \`desktop\` (1920x1080)
+  - \`mobile\` (375x812)
+  - \`tablet\` (768x1024)
+- Test both light and dark modes when relevant using \`dark_mode: true\`.
+- Use \`element_selector\` when focusing on a specific card component.
+
+\`\`\`json
+// Example call: ha_dashboard_render_screenshot
+{
+  "url_path": "lovelace/0",
+  "device_preset": "desktop",
+  "dark_mode": false
+}
+\`\`\`
+
+### Step 6: Visual Inspection Loop & Iteration
+Analyze the captured screenshot image using multimodal vision inspection:
+1. **Alignment & Grid Symmetry**: Are card borders aligned? Are heights balanced across columns?
+2. **Typography & Readability**: Are labels truncated? Is text overflowing container bounds?
+3. **Icons & States**: Are MDI icons rendering correctly? Are active entity states visually distinct?
+4. **Color & Contrast**: Do accent colors match the background theme in both light and dark mode?
+5. **Mobile Responsiveness**: Do horizontal stacks wrap cleanly without clipping horizontal scrollbars?
+
+*If any visual flaw or layout inconsistency is detected, return to Step 3, adjust the Lovelace YAML, re-save, and re-capture until the dashboard achieves optimal visual fidelity.*
+
+---
+
+## Tool Reference
+
+| Tool | Purpose | Key Parameters |
+| :--- | :--- | :--- |
+| \`ha_system_list_entities\` | Discover entities & states | \`domain_filter\`, \`search_query\` |
+| \`ha_dashboard_get_config\` | Fetch Lovelace dashboard YAML/JSON | \`dashboard_slug\` |
+| \`ha_dashboard_save_config\` | Snapshot, validate, and write dashboard | \`config_yaml\`, \`dashboard_slug\`, \`label\` |
+| \`ha_dashboard_render_screenshot\` | Headless Playwright visual capture | \`url_path\`, \`device_preset\`, \`dark_mode\`, \`element_selector\` |
+
+---
+
+## Safety Rules & Best Practices
+
+1. **Automatic Snapshot Preservation**: Never edit Lovelace files directly outside of \`ha_dashboard_save_config\`, ensuring an automatic snapshot ID is always generated for rollback.
+2. **Multi-Viewport Testing**: Every dashboard modification must be verified on both \`desktop\` and \`mobile\` presets before marking complete.
+3. **Graceful Entity Fallbacks**: Use conditional cards or friendly names so cards remain visually appealing even when sensors are temporarily unavailable.
+4. **Non-Destructive View Updates**: When adding new features, prefer creating dedicated views or sub-views rather than overwriting existing user dashboards without request.
+`,
+    "ha-automation-builder": `---
+name: ha-automation-builder
+description: SOP for drafting, validating, testing, and debugging Home Assistant automations and scripts safely.
+---
+
+# Home Assistant Automation Builder Skill
+
+## Overview
+
+The \`ha-automation-builder\` skill provides an end-to-end Standard Operating Procedure (SOP) for drafting, writing, validating, and testing Home Assistant automations and scripts. It enforces best practices such as unique ID assignment, syntax validation, automated snapshot generation before disk modification, live entity validation, and post-deployment trigger execution verification.
+
+---
+
+## Workflow & Steps
+
+\`\`\`mermaid
+flowchart TD
+    A[Step 1: Discover Entities & Services] --> B[Step 2: Read Existing Automations]
+    B --> C[Step 3: Construct Safe YAML Block]
+    C --> D[Step 4: Write Automation & Auto-Reload]
+    D --> E[Step 5: Test Trigger & Inspect Logs]
+    E --> F{Verification Check}
+    F -- Error in Logs --> C
+    F -- Success --> G[Complete]
+\`\`\`
+
+### Step 1: Discover Entity IDs & Services
+Before authoring automation logic, discover all target entities, their current states, supported attributes, and service domains.
+- Use \`ha_system_list_entities\` to look up sensor names, switch entity IDs, zone entities, or input helpers.
+- Verify entity domains (e.g. \`binary_sensor.front_door\`, \`light.hallway\`, \`climate.thermostat\`).
+
+\`\`\`json
+// Example call: ha_system_list_entities
+{
+  "domain_filter": "binary_sensor",
+  "search_query": "motion"
+}
+\`\`\`
+
+### Step 2: Read Existing Automations & Avoid Collisions
+Examine existing automations to avoid duplicate aliases, conflicting triggers, or ID collisions.
+- Use \`ha_automation_list\` with domain \`automation\` (or \`script\` / \`scene\`) to view active entity IDs, friendly names, and trigger times.
+- Use \`ha_automation_read\` with a specific automation ID or alias to inspect existing YAML structure and conventions.
+
+\`\`\`json
+// Example call: ha_automation_list
+{
+  "domain": "automation"
+}
+
+// Example call: ha_automation_read
+{
+  "automation_id": "night_light_auto_off"
+}
+\`\`\`
+
+### Step 3: Construct Safe YAML Automation Blocks
+Structure the automation with clear metadata, robust triggers, defensive conditions, and appropriate execution modes.
+- **Unique Identifier**: Always assign a deterministic or timestamped \`id\` (e.g. \`id: '1725100000123'\` or \`id: auto_living_room_motion\`).
+- **Alias & Description**: Provide a clear human-readable \`alias\` and \`description\`.
+- **Triggers**: Define precise triggers with thresholds or duration (e.g. \`for: { minutes: 5 }\`).
+- **Conditions**: Use conditions to filter execution (e.g. sun elevation, state conditions, time ranges).
+- **Actions**: Utilize official Home Assistant service targets (\`action:\` / \`service:\`) and avoid deprecated syntax.
+- **Execution Mode**: Choose the appropriate \`mode\`:
+  - \`single\`: Default, drops concurrent triggers.
+  - \`restart\`: Ideal for motion timers (resets timer on new motion).
+  - \`queued\`: Enqueues triggers up to \`max\`.
+  - \`parallel\`: Executes independently up to \`max\`.
+
+\`\`\`yaml
+- id: "auto_hallway_motion_light"
+  alias: "Hallway: Motion-Activated Nightlight"
+  description: "Turn on hallway light on motion after sunset and turn off after 3 minutes of no motion."
+  mode: restart
+  trigger:
+    - platform: state
+      entity_id: binary_sensor.hallway_motion
+      to: "on"
+  condition:
+    - condition: state
+      entity_id: sun.sun
+      state: "below_horizon"
+  action:
+    - action: light.turn_on
+      target:
+        entity_id: light.hallway
+      data:
+        brightness_pct: 30
+    - wait_for_trigger:
+        - platform: state
+          entity_id: binary_sensor.hallway_motion
+          to: "off"
+          for:
+            minutes: 3
+    - action: light.turn_off
+      target:
+        entity_id: light.hallway
+\`\`\`
+
+### Step 4: Write Automation with Auto-Reload & Snapshot
+Write the automation block to \`automations.yaml\` safely.
+- Use \`ha_automation_write\` providing the \`automation_id\`, \`yaml_code\`, and a descriptive \`label\`.
+- Note: \`ha_automation_write\` automatically creates a safety snapshot in the Addon storage, validates YAML syntax, appends or updates the target automation block, and triggers \`automation.reload\`.
+
+\`\`\`json
+// Example call: ha_automation_write
+{
+  "automation_id": "auto_hallway_motion_light",
+  "label": "Add hallway nightlight motion automation",
+  "yaml_code": "- id: 'auto_hallway_motion_light'\\n  alias: 'Hallway: Motion-Activated Nightlight'\\n  mode: restart\\n  trigger:\\n    - platform: state\\n      entity_id: binary_sensor.hallway_motion\\n      to: 'on'\\n  action:\\n    - action: light.turn_on\\n      target:\\n        entity_id: light.hallway\\n"
+}
+\`\`\`
+
+### Step 5: Test Trigger & Inspect Execution Logs
+Validate that the newly registered automation triggers properly and executes its action sequence without runtime errors.
+- Use \`ha_automation_trigger\` with \`entity_id\` (e.g. \`automation.hallway_motion_activated_nightlight\`).
+- Use \`ha_system_get_logs\` to tail the latest logs and confirm clean execution with zero template errors or missing service faults.
+
+\`\`\`json
+// Example call: ha_automation_trigger
+{
+  "entity_id": "automation.hallway_motion_activated_nightlight"
+}
+
+// Example call: ha_system_get_logs
+{
+  "lines_count": 50
+}
+\`\`\`
+
+---
+
+## Tool Reference
+
+| Tool | Purpose | Key Parameters |
+| :--- | :--- | :--- |
+| \`ha_system_list_entities\` | Query entity IDs, states, attributes | \`domain_filter\`, \`search_query\` |
+| \`ha_automation_list\` | List automations, scripts, or scenes | \`domain\` |
+| \`ha_automation_read\` | Fetch YAML block of an automation | \`automation_id\` |
+| \`ha_automation_write\` | Validate, snapshot, write YAML & reload | \`automation_id\`, \`yaml_code\`, \`label\` |
+| \`ha_automation_trigger\` | Execute automation trigger manually | \`entity_id\` |
+| \`ha_system_get_logs\` | Retrieve sanitized core log lines | \`lines_count\` |
+
+---
+
+## Safety Rules & Best Practices
+
+1. **Unique ID Requirement**: Every automation block MUST have an explicit \`id\` field to enable UI editing and targeted updates.
+2. **Deterministic Reloading**: Never rely on full Home Assistant restarts for automation testing; use \`ha_automation_write\`'s built-in service reload.
+3. **Log Verification Gate**: Never declare an automation complete without checking \`ha_system_get_logs\` for template or service execution warnings.
+4. **Appropriate Mode Selection**: Use \`mode: restart\` for motion/timer automations and \`mode: single\` or \`mode: queued\` for security/alert automations.
+`,
+    "ha-troubleshooter": `---
+name: ha-troubleshooter
+description: SOP for diagnosing Home Assistant errors, reviewing sanitized system logs, and executing safety rollbacks.
+---
+
+# Home Assistant Troubleshooter Skill
+
+## Overview
+
+The \`ha-troubleshooter\` skill establishes a structured, safety-first Standard Operating Procedure (SOP) for diagnosing system faults, analyzing sanitized log traces, detecting configuration syntax errors or integration crashes, and performing instant, non-destructive snapshot rollbacks in Home Assistant.
+
+---
+
+## Workflow & Steps
+
+\`\`\`mermaid
+flowchart TD
+    A[Step 1: System Healthcheck] --> B[Step 2: Tail & Analyze Logs]
+    B --> C{Fault / Regression Detected?}
+    C -- No Fault --> D[System Operational]
+    C -- Yes --> E[Step 3: Execute Safety Rollback]
+    E --> F[Step 4: Verify Post-Restore Health]
+    F --> G[Log Post-Mortem & Fix Root Cause]
+\`\`\`
+
+### Step 1: System Healthcheck
+Initiate diagnostics by checking the operational status of both the Home Assistant Core API and the AI Addon helper daemon.
+- Use \`ha_system_health\` to evaluate connectivity, component reachability, and API response latencies.
+- Determine whether Home Assistant is running in normal, degraded, or recovery state.
+
+\`\`\`json
+// Example call: ha_system_health
+{}
+\`\`\`
+
+### Step 2: Tail & Analyze Sanitized Logs
+Inspect system logs to identify tracebacks, deprecation warnings, unhandled exceptions, template rendering faults, or integration connection failures.
+- Use \`ha_system_get_logs\` specifying \`lines_count\` (e.g. 50-200 lines) and optionally \`source\` (\`core\`, \`supervisor\`, \`all\`).
+- Note: System logs are automatically sanitized by the Addon backend to redact sensitive tokens, passwords, and authorization headers.
+- Categorize observed errors:
+  - **YAML / Syntax Errors**: Invalid keys, missing indentation, or schema validation failures in \`configuration.yaml\`, \`automations.yaml\`, or dashboards.
+  - **Entity / Device Unavailable**: Missing integrations, offline Zigbee/Z-Wave nodes, or changed entity IDs.
+  - **Service Call Failures**: Invocation of nonexistent services or missing target parameters.
+
+\`\`\`json
+// Example call: ha_system_get_logs
+{
+  "lines_count": 100,
+  "source": "all"
+}
+\`\`\`
+
+### Step 3: Execute Safety Rollback or Manual Backup
+When an edit, automation change, or dashboard update leads to instability, regression, or syntax errors, perform an immediate safety rollback.
+- If performing experimental diagnostics before a fix, create a pre-fix checkpoint using \`ha_system_create_backup\` with a descriptive \`label\`.
+- If an issue was introduced by a previous tool call, locate the corresponding \`snapshot_id\` from the tool response or snapshot history.
+- Use \`ha_system_restore_backup\` with \`snapshot_id\` to restore the file atomically. The Addon automatically creates a safety backup of current disk state before restoring.
+
+\`\`\`json
+// Example call: ha_system_create_backup
+{
+  "label": "Pre-troubleshooting configuration checkpoint"
+}
+
+// Example call: ha_system_restore_backup
+{
+  "snapshot_id": "snap_20260831_093000_automations_yaml"
+}
+\`\`\`
+
+### Step 4: Verify Post-Restore System Health
+After executing a rollback or applying a corrective patch, verify that the system has returned to full operational capacity.
+- Re-run \`ha_system_health\` to verify that API and daemon health check reports are \`ok\`.
+- Tail recent logs with \`ha_system_get_logs\` to ensure error loops and exception tracebacks have cleared.
+
+\`\`\`json
+// Example call: ha_system_health
+{}
+
+// Example call: ha_system_get_logs
+{
+  "lines_count": 50
+}
+\`\`\`
+
+---
+
+## Tool Reference
+
+| Tool | Purpose | Key Parameters |
+| :--- | :--- | :--- |
+| \`ha_system_health\` | Query HA Core API & Addon daemon health | *(none)* |
+| \`ha_system_get_logs\` | Fetch sanitized tail of HA core & supervisor logs | \`lines_count\`, \`source\` |
+| \`ha_system_create_backup\` | Create named manual snapshot backup | \`label\` |
+| \`ha_system_restore_backup\` | Restore configuration from snapshot ID | \`snapshot_id\` |
+
+---
+
+## Safety Rules & Best Practices
+
+1. **Non-Destructive Restoration**: All restore operations conducted via \`ha_system_restore_backup\` automatically preserve the overwritten version in a safety snapshot.
+2. **Sanitized Output Awareness**: \`ha_system_get_logs\` redacts secrets; never attempt to bypass log sanitization to inspect raw credentials.
+3. **Rollback Over Patching Broken States**: When an unverified configuration breaks critical automations, roll back to the last known good snapshot before attempting redesigns.
+4. **Mandatory Post-Restore Verification**: Always verify both \`ha_system_health\` and \`ha_system_get_logs\` after any restore or configuration repair.
+`
+};
+export function getTargetSkillsDirectories(customDir) {
+    if (customDir) {
+        return [path.resolve(customDir)];
+    }
+    const homedir = os.homedir();
+    const candidates = [];
+    const geminiSkills = path.join(homedir, ".gemini", "config", "skills");
+    if (fs.existsSync(geminiSkills)) {
+        candidates.push(geminiSkills);
+    }
+    const claudeSkills = path.join(homedir, ".claude", "skills");
+    if (fs.existsSync(claudeSkills)) {
+        candidates.push(claudeSkills);
+    }
+    const opencodeSkills = path.join(homedir, ".opencode", "skills");
+    if (fs.existsSync(opencodeSkills)) {
+        candidates.push(opencodeSkills);
+    }
+    // If none exist, default to gemini skills path
+    if (candidates.length === 0) {
+        candidates.push(geminiSkills);
+    }
+    return candidates;
+}
+export function syncSkills(customDir, silent = false) {
+    const targetDirs = getTargetSkillsDirectories(customDir);
+    let installedCount = 0;
+    for (const baseDir of targetDirs) {
+        if (!fs.existsSync(baseDir)) {
+            try {
+                fs.mkdirSync(baseDir, { recursive: true });
+            }
+            catch {
+                continue;
+            }
+        }
+        for (const [skillName, content] of Object.entries(EMBEDDED_SKILLS)) {
+            try {
+                const skillDir = path.join(baseDir, skillName);
+                if (!fs.existsSync(skillDir)) {
+                    fs.mkdirSync(skillDir, { recursive: true });
+                }
+                const skillPath = path.join(skillDir, "SKILL.md");
+                fs.writeFileSync(skillPath, content, "utf8");
+                installedCount++;
+                if (!silent) {
+                    console.log(`✓ Synchronized skill: ${skillName} -> ${skillPath}`);
+                }
+            }
+            catch (err) {
+                if (!silent) {
+                    console.warn(`⚠️ Failed writing skill ${skillName} to ${baseDir}:`, err.message);
+                }
+            }
+        }
+    }
+    return { installedCount, targetDirs };
+}
+//# sourceMappingURL=skills.js.map

package/dist/cli/skills.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.js","sourceRoot":"","sources":["../../src/cli/skills.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -6,5 +6,6 @@ export declare function createServer(providedClients?: ToolClients): {
     server: McpServer;
     clients: ToolClients;
 };
-export declare const createMcpServer: typeof createServer;
+import { syncSkills } from "./cli/skills.js";
+export { syncSkills };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAcpE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,wBAAgB,aAAa,IAAI,WAAW,CAY3C;AAED,wBAAgB,YAAY,CAAC,eAAe,CAAC,EAAE,WAAW,GAAG;IAC3D,MAAM,EAAE,SAAS,CAAC;IAClB,OAAO,EAAE,WAAW,CAAC;CACtB,CAaA;AAGD,eAAO,MAAM,eAAe,qBAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAcpE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,wBAAgB,aAAa,IAAI,WAAW,CAY3C;AAED,wBAAgB,YAAY,CAAC,eAAe,CAAC,EAAE,WAAW,GAAG;IAC3D,MAAM,EAAE,SAAS,CAAC;IAClB,OAAO,EAAE,WAAW,CAAC;CACtB,CAaA;AAED,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,OAAO,EAAE,UAAU,EAAE,CAAC"}

package/dist/index.js

@@ -35,9 +35,26 @@ export function createServer(providedClients) {
     registerSystemTools(server, clients);
     return { server, clients };
 }
-// Backward-compatible alias
-export const createMcpServer = createServer;
+import { syncSkills } from "./cli/skills.js";
+export { syncSkills };
 async function main() {
+    const args = process.argv.slice(2);
+    if (args.includes("install-skills") || args.includes("update-skills") || args.includes("sync-skills")) {
+        const customDir = args.find((a) => a.startsWith("--dir="))?.split("=")[1];
+        console.log("🚀 Synchronizing Home Assistant AI Skills...");
+        const result = syncSkills(customDir, false);
+        console.log(`✨ Successfully synchronized ${result.installedCount} skill files across ${result.targetDirs.length} directories.`);
+        process.exit(0);
+    }
+    // Background auto-sync skills if enabled or if standard skills folder exists
+    if (process.env.AUTO_SYNC_SKILLS !== "false") {
+        try {
+            syncSkills(undefined, true);
+        }
+        catch {
+            // Non-blocking auto-sync
+        }
+    }
     const { server, clients } = createServer();
     const transport = new StdioServerTransport();
     const cleanup = async () => {

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AACjE,OAAO,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AACjE,OAAO,EAAE,0BAA0B,EAAE,MAAM,0CAA0C,CAAC;AACtF,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAGxD,MAAM,UAAU,aAAa;IAC3B,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAC5B,MAAM,UAAU,GAAG,IAAI,aAAa,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;IACvF,MAAM,QAAQ,GAAG,IAAI,WAAW,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;IACnF,MAAM,WAAW,GAAG,IAAI,YAAY,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC/F,MAAM,QAAQ,GAAG,IAAI,0BAA0B,CAAC;QAC9C,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,eAAe,EAAE,MAAM,CAAC,eAAe;KACxC,CAAC,CAAC;IAEH,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,eAA6B;IAIxD,MAAM,OAAO,GAAG,eAAe,IAAI,aAAa,EAAE,CAAC;IAEnD,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,OAAO;KACjB,CAAC,CAAC;IAEH,sBAAsB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,uBAAuB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzC,mBAAmB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAErC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;AAC7B,CAAC;AAED,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,OAAO,EAAE,UAAU,EAAE,CAAC;AAEtB,KAAK,UAAU,IAAI;IACjB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACnC,IAAI,IAAI,CAAC,QAAQ,CAAC,gBAAgB,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC;QACtG,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QAC1E,OAAO,CAAC,GAAG,CAAC,8CAA8C,CAAC,CAAC;QAC5D,MAAM,MAAM,GAAG,UAAU,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;QAC5C,OAAO,CAAC,GAAG,CAAC,+BAA+B,MAAM,CAAC,cAAc,uBAAuB,MAAM,CAAC,UAAU,CAAC,MAAM,eAAe,CAAC,CAAC;QAChI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,6EAA6E;IAC7E,IAAI,OAAO,CAAC,GAAG,CAAC,gBAAgB,KAAK,OAAO,EAAE,CAAC;QAC7C,IAAI,CAAC;YACH,UAAU,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QAC9B,CAAC;QAAC,MAAM,CAAC;YACP,yBAAyB;QAC3B,CAAC;IACH,CAAC;IAED,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,YAAY,EAAE,CAAC;IAC3C,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAE7C,MAAM,OAAO,GAAG,KAAK,IAAI,EAAE;QACzB,aAAa,CAAC,IAAI,CAAC,+CAA+C,CAAC,CAAC;QACpE,IAAI,CAAC;YACH,OAAO,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC;YAC9B,MAAM,OAAO,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;YAC/B,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;QACvB,CAAC;QAAC,MAAM,CAAC;YACP,qCAAqC;QACvC,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC;IAEF,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC9B,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAE/B,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAChC,aAAa,CAAC,IAAI,CAAC,gDAAgD,CAAC,CAAC;IACvE,CAAC;IAAC,OAAO,GAAQ,EAAE,CAAC;QAClB,aAAa,CAAC,KAAK,CAAC,iCAAiC,EAAE,GAAG,CAAC,CAAC;QAC5D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,MAAM,kBAAkB,GAAG,GAAY,EAAE;IACvC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC;IACnC,IAAI,CAAC;QACH,MAAM,eAAe,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;QACrE,MAAM,kBAAkB,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;QACvE,MAAM,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;QACxE,OAAO,CACL,eAAe,KAAK,kBAAkB;YACtC,aAAa,CAAC,QAAQ,CAAC,eAAe,CAAC;YACvC,aAAa,CAAC,QAAQ,CAAC,cAAc,CAAC,CACvC,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC,CAAC;AAEF,IAAI,kBAAkB,EAAE,EAAE,CAAC;IACzB,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;QACnB,aAAa,CAAC,KAAK,CAAC,4BAA4B,EAAE,GAAG,CAAC,CAAC;QACvD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/tools/system.js

@@ -21,7 +21,7 @@ export const getLogsSchema = {
         .enum(["core", "supervisor", "all"])
         .optional()
         .default("all")
-        .describe("Log source to query ('core' for HA Core events, 'supervisor' for Docker/Add-on lifecycle, 'all' for combined)"),
+        .describe("Log source to query ('core' for HA Core events, 'supervisor' for Docker/App lifecycle, 'all' for combined)"),
 };
 export const createBackupSchema = {
     label: z

package/dist/tools/system.js.map

@@ -1 +1 @@
-{"version":3,"file":"system.js","sourceRoot":"","sources":["../../src/tools/system.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"system.js","sourceRoot":"","sources":["../../src/tools/system.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,11 +1,12 @@
 {
   "name": "ha-ai-mcp-server",
-  "version": "0.3.8",
+  "version": "0.3.9",
   "description": "Model Context Protocol server for Home Assistant with Playwright visual feedback",
   "type": "module",
   "main": "dist/index.js",
   "bin": {
-    "ha-ai-mcp": "./dist/index.js"
+    "ha-ai-mcp": "./dist/index.js",
+    "ha-ai-mcp-server": "./dist/index.js"
   },
   "scripts": {
     "build": "tsc",
@@ -35,5 +36,14 @@
     "lovelace",
     "ai-agents"
   ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/sserhii-tech/home-assistant-mcp.git",
+    "directory": "mcp-server"
+  },
+  "homepage": "https://github.com/sserhii-tech/home-assistant-mcp#readme",
+  "bugs": {
+    "url": "https://github.com/sserhii-tech/home-assistant-mcp/issues"
+  },
   "license": "Apache-2.0"
 }

package/src/cli/skills.ts

@@ -0,0 +1,555 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+import * as os from "node:os";
+
+export interface SkillDefinition {
+  name: string;
+  description: string;
+  content: string;
+}
+
+export const EMBEDDED_SKILLS: Record<string, string> = {
+  "ha-device-controller": `---
+name: ha-device-controller
+description: SOP for safely discovering entities, calling Home Assistant services, controlling smart devices, and verifying state transitions.
+---
+
+# Home Assistant Device Controller Skill
+
+## Overview
+
+The \`ha-device-controller\` skill defines the Standard Operating Procedure (SOP) for querying real-time smart device states, invoking Home Assistant domain services (lights, switches, climate, media players, covers), and validating that the target hardware correctly transitions state.
+
+---
+
+## Workflow & Steps
+
+\`\`\`mermaid
+flowchart TD
+    A[Step 1: Discover Entity & Current State] --> B[Step 2: Validate Domain & Payload Schema]
+    B --> C[Step 3: Execute Service Call]
+    C --> D[Step 4: Verify Post-Execution State]
+    D --> E{State Verified?}
+    E -- Yes --> F[Success & Report Confirmation]
+    E -- No --> G[Inspect System Logs & Diagnose]
+\`\`\`
+
+### Step 1: Discover Entity & Current State
+Before sending control commands or invoking services, locate the exact target entity ID and inspect its current attributes.
+- Use \`ha_system_list_entities\` with \`domain_filter\` (e.g. \`light\`, \`switch\`, \`climate\`) or \`search_query\`.
+- Verify the current \`state\` (e.g., \`off\` vs \`on\`), supported color modes, preset modes, or available features.
+
+\`\`\`json
+// Example call: ha_system_list_entities
+{
+  "domain_filter": "light",
+  "search_query": "office"
+}
+\`\`\`
+
+### Step 2: Validate Domain & Payload Schema
+Construct the service invocation payload matching Home Assistant Core service specifications.
+- Common services include:
+  - \`light.turn_on\`, \`light.turn_off\`, \`light.toggle\` (with \`brightness\`, \`rgb_color\`, \`color_temp_kelvin\`)
+  - \`switch.turn_on\`, \`switch.turn_off\`, \`switch.toggle\`
+  - \`climate.set_temperature\`, \`climate.set_hvac_mode\` (with \`temperature\`, \`hvac_mode\`)
+  - \`cover.open_cover\`, \`cover.close_cover\`, \`cover.set_cover_position\`
+  - \`homeassistant.update_entity\`, \`homeassistant.reload_all\`
+
+### Step 3: Execute Service Call
+Invoke the service using \`ha_system_call_service\`.
+- Provide the \`domain\`, \`service\`, and \`service_data\` payload.
+
+\`\`\`json
+// Example call: ha_system_call_service
+{
+  "domain": "light",
+  "service": "turn_on",
+  "service_data": {
+    "entity_id": "light.office_light",
+    "brightness": 200
+  }
+}
+\`\`\`
+
+### Step 4: Verify Post-Execution State
+Confirm that the physical device or software entity acknowledged the command and changed state.
+- Re-query \`ha_system_list_entities\` with \`search_query\` targeting the entity.
+- Compare \`last_changed\` and \`state\` against expected outcome.
+- If the entity remains unchanged or reports \`unavailable\`, tail recent logs with \`ha_system_get_logs\` to diagnose integration communication errors.
+
+---
+
+## Tool Reference
+
+| Tool | Purpose | Key Parameters |
+| :--- | :--- | :--- |
+| \`ha_system_list_entities\` | Discover entities and inspect live states | \`domain_filter\`, \`search_query\` |
+| \`ha_system_call_service\` | Call any Home Assistant domain service | \`domain\`, \`service\`, \`service_data\` |
+| \`ha_system_get_logs\` | Inspect system error logs on failures | \`lines_count\`, \`source\` |
+| \`ha_system_health\` | Verify API and integration connectivity | *(none)* |
+
+---
+
+## Safety Rules & Best Practices
+
+1. **Verify Before Execution**: Always confirm entity identity with \`ha_system_list_entities\` before triggering destructive or high-energy actions (heaters, locks, garage doors).
+2. **Post-State Validation**: Never assume a service call succeeded solely based on HTTP 200; verify the entity \`state\` afterwards.
+3. **Graceful Error Handling**: If a device fails to respond, inspect \`ha_system_get_logs\` for Zigbee/Z-Wave/Wi-Fi timeout errors before retrying in a loop.
+`,
+
+  "ha-dashboard-designer": `---
+name: ha-dashboard-designer
+description: SOP for creating, previewing, and visually iterating Home Assistant Lovelace dashboards using MCP tools and Playwright screenshots.
+---
+
+# Home Assistant Dashboard Designer Skill
+
+## Overview
+
+The \`ha-dashboard-designer\` skill provides a complete Standard Operating Procedure (SOP) for creating, modifying, and polishing Home Assistant Lovelace dashboards with AI-driven visual validation. By combining entity discovery, configuration management with automatic snapshot safety, and headless Playwright screenshot rendering, this skill ensures dashboards are aesthetically refined, responsive across devices, and functional.
+
+---
+
+## Workflow & Steps
+
+\`\`\`mermaid
+flowchart TD
+    A[Step 1: Discover Entities] --> B[Step 2: Inspect Dashboard Config]
+    B --> C[Step 3: Propose Layout & Cards]
+    C --> D[Step 4: Save Lovelace YAML]
+    D --> E[Step 5: Capture Screenshots]
+    E --> F{Step 6: Visual Inspection Loop}
+    F -- Issues Found --> C
+    F -- Approved --> G[Finalize & Present]
+\`\`\`
+
+### Step 1: Query Available Entities
+Before designing or modifying any dashboard cards, discover the available entities, their domains, states, friendly names, and device classes.
+- Use \`ha_system_list_entities\` with domain filters (e.g. \`light\`, \`climate\`, \`sensor\`, \`switch\`, \`media_player\`) or search terms.
+- Verify entity availability and state types (e.g. numeric sensors, binary on/off states, list attributes).
+
+\`\`\`json
+// Example call: ha_system_list_entities
+{
+  "domain_filter": "climate",
+  "search_query": "living_room"
+}
+\`\`\`
+
+### Step 2: Inspect Existing Dashboard Configuration
+Inspect the current dashboard configuration to maintain theme consistency, title naming conventions, badge configurations, and view hierarchy.
+- Use \`ha_dashboard_get_config\` with the target \`dashboard_slug\` (e.g. \`lovelace\` for default or custom slugs like \`dashboard-energy\`).
+- Analyze existing views, card types, custom themes, and column layouts.
+
+\`\`\`json
+// Example call: ha_dashboard_get_config
+{
+  "dashboard_slug": "lovelace"
+}
+\`\`\`
+
+### Step 3: Propose Card Layout & Design
+Design card layouts tailored to the user requirements and device constraints:
+- **Card Selection**:
+  - **Tile Card**: Modern HA standard for lights, switches, media players with feature controls.
+  - **Mushroom Cards**: Minimalist, touch-friendly UI for room summaries, chips, and climate.
+  - **Grid & Stacks**: \`grid\`, \`horizontal-stack\`, and \`vertical-stack\` for structured alignment.
+  - **Glance & Entities**: Compact summaries for sensors (temperatures, battery levels).
+  - **ApexCharts & Gauges**: Historical trends, energy metrics, and analog gauges.
+  - **Conditional Cards**: Dynamic cards that appear only when specific states match (e.g. doors open, low battery).
+- **Responsive Guidelines**:
+  - Use 2-4 columns on desktop layouts.
+  - Ensure single-column or wrapping behavior on mobile screens.
+  - Group cards logically by room or domain.
+
+### Step 4: Save Lovelace YAML Configuration
+Apply the updated dashboard configuration safely.
+- Use \`ha_dashboard_save_config\` supplying the YAML configuration, target \`dashboard_slug\`, and a descriptive \`label\`.
+- Note: \`ha_dashboard_save_config\` automatically creates a safety snapshot before applying modifications and performs YAML schema validation.
+
+\`\`\`json
+// Example call: ha_dashboard_save_config
+{
+  "dashboard_slug": "lovelace",
+  "label": "Add living room climate tile and energy gauge",
+  "config_yaml": "title: Home\\nviews:\\n  - title: Main\\n    path: main\\n    cards:\\n      - type: tile\\n        entity: light.living_room\\n"
+}
+\`\`\`
+
+### Step 5: Capture Rendered Screenshots
+Verify the visual rendering of the updated dashboard using the headless Playwright browser.
+- Use \`ha_dashboard_render_screenshot\` with the target \`url_path\` (e.g. \`lovelace/0\`, \`dashboard-energy\`).
+- Always test across multiple device presets:
+  - \`desktop\` (1920x1080)
+  - \`mobile\` (375x812)
+  - \`tablet\` (768x1024)
+- Test both light and dark modes when relevant using \`dark_mode: true\`.
+- Use \`element_selector\` when focusing on a specific card component.
+
+\`\`\`json
+// Example call: ha_dashboard_render_screenshot
+{
+  "url_path": "lovelace/0",
+  "device_preset": "desktop",
+  "dark_mode": false
+}
+\`\`\`
+
+### Step 6: Visual Inspection Loop & Iteration
+Analyze the captured screenshot image using multimodal vision inspection:
+1. **Alignment & Grid Symmetry**: Are card borders aligned? Are heights balanced across columns?
+2. **Typography & Readability**: Are labels truncated? Is text overflowing container bounds?
+3. **Icons & States**: Are MDI icons rendering correctly? Are active entity states visually distinct?
+4. **Color & Contrast**: Do accent colors match the background theme in both light and dark mode?
+5. **Mobile Responsiveness**: Do horizontal stacks wrap cleanly without clipping horizontal scrollbars?
+
+*If any visual flaw or layout inconsistency is detected, return to Step 3, adjust the Lovelace YAML, re-save, and re-capture until the dashboard achieves optimal visual fidelity.*
+
+---
+
+## Tool Reference
+
+| Tool | Purpose | Key Parameters |
+| :--- | :--- | :--- |
+| \`ha_system_list_entities\` | Discover entities & states | \`domain_filter\`, \`search_query\` |
+| \`ha_dashboard_get_config\` | Fetch Lovelace dashboard YAML/JSON | \`dashboard_slug\` |
+| \`ha_dashboard_save_config\` | Snapshot, validate, and write dashboard | \`config_yaml\`, \`dashboard_slug\`, \`label\` |
+| \`ha_dashboard_render_screenshot\` | Headless Playwright visual capture | \`url_path\`, \`device_preset\`, \`dark_mode\`, \`element_selector\` |
+
+---
+
+## Safety Rules & Best Practices
+
+1. **Automatic Snapshot Preservation**: Never edit Lovelace files directly outside of \`ha_dashboard_save_config\`, ensuring an automatic snapshot ID is always generated for rollback.
+2. **Multi-Viewport Testing**: Every dashboard modification must be verified on both \`desktop\` and \`mobile\` presets before marking complete.
+3. **Graceful Entity Fallbacks**: Use conditional cards or friendly names so cards remain visually appealing even when sensors are temporarily unavailable.
+4. **Non-Destructive View Updates**: When adding new features, prefer creating dedicated views or sub-views rather than overwriting existing user dashboards without request.
+`,
+
+  "ha-automation-builder": `---
+name: ha-automation-builder
+description: SOP for drafting, validating, testing, and debugging Home Assistant automations and scripts safely.
+---
+
+# Home Assistant Automation Builder Skill
+
+## Overview
+
+The \`ha-automation-builder\` skill provides an end-to-end Standard Operating Procedure (SOP) for drafting, writing, validating, and testing Home Assistant automations and scripts. It enforces best practices such as unique ID assignment, syntax validation, automated snapshot generation before disk modification, live entity validation, and post-deployment trigger execution verification.
+
+---
+
+## Workflow & Steps
+
+\`\`\`mermaid
+flowchart TD
+    A[Step 1: Discover Entities & Services] --> B[Step 2: Read Existing Automations]
+    B --> C[Step 3: Construct Safe YAML Block]
+    C --> D[Step 4: Write Automation & Auto-Reload]
+    D --> E[Step 5: Test Trigger & Inspect Logs]
+    E --> F{Verification Check}
+    F -- Error in Logs --> C
+    F -- Success --> G[Complete]
+\`\`\`
+
+### Step 1: Discover Entity IDs & Services
+Before authoring automation logic, discover all target entities, their current states, supported attributes, and service domains.
+- Use \`ha_system_list_entities\` to look up sensor names, switch entity IDs, zone entities, or input helpers.
+- Verify entity domains (e.g. \`binary_sensor.front_door\`, \`light.hallway\`, \`climate.thermostat\`).
+
+\`\`\`json
+// Example call: ha_system_list_entities
+{
+  "domain_filter": "binary_sensor",
+  "search_query": "motion"
+}
+\`\`\`
+
+### Step 2: Read Existing Automations & Avoid Collisions
+Examine existing automations to avoid duplicate aliases, conflicting triggers, or ID collisions.
+- Use \`ha_automation_list\` with domain \`automation\` (or \`script\` / \`scene\`) to view active entity IDs, friendly names, and trigger times.
+- Use \`ha_automation_read\` with a specific automation ID or alias to inspect existing YAML structure and conventions.
+
+\`\`\`json
+// Example call: ha_automation_list
+{
+  "domain": "automation"
+}
+
+// Example call: ha_automation_read
+{
+  "automation_id": "night_light_auto_off"
+}
+\`\`\`
+
+### Step 3: Construct Safe YAML Automation Blocks
+Structure the automation with clear metadata, robust triggers, defensive conditions, and appropriate execution modes.
+- **Unique Identifier**: Always assign a deterministic or timestamped \`id\` (e.g. \`id: '1725100000123'\` or \`id: auto_living_room_motion\`).
+- **Alias & Description**: Provide a clear human-readable \`alias\` and \`description\`.
+- **Triggers**: Define precise triggers with thresholds or duration (e.g. \`for: { minutes: 5 }\`).
+- **Conditions**: Use conditions to filter execution (e.g. sun elevation, state conditions, time ranges).
+- **Actions**: Utilize official Home Assistant service targets (\`action:\` / \`service:\`) and avoid deprecated syntax.
+- **Execution Mode**: Choose the appropriate \`mode\`:
+  - \`single\`: Default, drops concurrent triggers.
+  - \`restart\`: Ideal for motion timers (resets timer on new motion).
+  - \`queued\`: Enqueues triggers up to \`max\`.
+  - \`parallel\`: Executes independently up to \`max\`.
+
+\`\`\`yaml
+- id: "auto_hallway_motion_light"
+  alias: "Hallway: Motion-Activated Nightlight"
+  description: "Turn on hallway light on motion after sunset and turn off after 3 minutes of no motion."
+  mode: restart
+  trigger:
+    - platform: state
+      entity_id: binary_sensor.hallway_motion
+      to: "on"
+  condition:
+    - condition: state
+      entity_id: sun.sun
+      state: "below_horizon"
+  action:
+    - action: light.turn_on
+      target:
+        entity_id: light.hallway
+      data:
+        brightness_pct: 30
+    - wait_for_trigger:
+        - platform: state
+          entity_id: binary_sensor.hallway_motion
+          to: "off"
+          for:
+            minutes: 3
+    - action: light.turn_off
+      target:
+        entity_id: light.hallway
+\`\`\`
+
+### Step 4: Write Automation with Auto-Reload & Snapshot
+Write the automation block to \`automations.yaml\` safely.
+- Use \`ha_automation_write\` providing the \`automation_id\`, \`yaml_code\`, and a descriptive \`label\`.
+- Note: \`ha_automation_write\` automatically creates a safety snapshot in the Addon storage, validates YAML syntax, appends or updates the target automation block, and triggers \`automation.reload\`.
+
+\`\`\`json
+// Example call: ha_automation_write
+{
+  "automation_id": "auto_hallway_motion_light",
+  "label": "Add hallway nightlight motion automation",
+  "yaml_code": "- id: 'auto_hallway_motion_light'\\n  alias: 'Hallway: Motion-Activated Nightlight'\\n  mode: restart\\n  trigger:\\n    - platform: state\\n      entity_id: binary_sensor.hallway_motion\\n      to: 'on'\\n  action:\\n    - action: light.turn_on\\n      target:\\n        entity_id: light.hallway\\n"
+}
+\`\`\`
+
+### Step 5: Test Trigger & Inspect Execution Logs
+Validate that the newly registered automation triggers properly and executes its action sequence without runtime errors.
+- Use \`ha_automation_trigger\` with \`entity_id\` (e.g. \`automation.hallway_motion_activated_nightlight\`).
+- Use \`ha_system_get_logs\` to tail the latest logs and confirm clean execution with zero template errors or missing service faults.
+
+\`\`\`json
+// Example call: ha_automation_trigger
+{
+  "entity_id": "automation.hallway_motion_activated_nightlight"
+}
+
+// Example call: ha_system_get_logs
+{
+  "lines_count": 50
+}
+\`\`\`
+
+---
+
+## Tool Reference
+
+| Tool | Purpose | Key Parameters |
+| :--- | :--- | :--- |
+| \`ha_system_list_entities\` | Query entity IDs, states, attributes | \`domain_filter\`, \`search_query\` |
+| \`ha_automation_list\` | List automations, scripts, or scenes | \`domain\` |
+| \`ha_automation_read\` | Fetch YAML block of an automation | \`automation_id\` |
+| \`ha_automation_write\` | Validate, snapshot, write YAML & reload | \`automation_id\`, \`yaml_code\`, \`label\` |
+| \`ha_automation_trigger\` | Execute automation trigger manually | \`entity_id\` |
+| \`ha_system_get_logs\` | Retrieve sanitized core log lines | \`lines_count\` |
+
+---
+
+## Safety Rules & Best Practices
+
+1. **Unique ID Requirement**: Every automation block MUST have an explicit \`id\` field to enable UI editing and targeted updates.
+2. **Deterministic Reloading**: Never rely on full Home Assistant restarts for automation testing; use \`ha_automation_write\`'s built-in service reload.
+3. **Log Verification Gate**: Never declare an automation complete without checking \`ha_system_get_logs\` for template or service execution warnings.
+4. **Appropriate Mode Selection**: Use \`mode: restart\` for motion/timer automations and \`mode: single\` or \`mode: queued\` for security/alert automations.
+`,
+
+  "ha-troubleshooter": `---
+name: ha-troubleshooter
+description: SOP for diagnosing Home Assistant errors, reviewing sanitized system logs, and executing safety rollbacks.
+---
+
+# Home Assistant Troubleshooter Skill
+
+## Overview
+
+The \`ha-troubleshooter\` skill establishes a structured, safety-first Standard Operating Procedure (SOP) for diagnosing system faults, analyzing sanitized log traces, detecting configuration syntax errors or integration crashes, and performing instant, non-destructive snapshot rollbacks in Home Assistant.
+
+---
+
+## Workflow & Steps
+
+\`\`\`mermaid
+flowchart TD
+    A[Step 1: System Healthcheck] --> B[Step 2: Tail & Analyze Logs]
+    B --> C{Fault / Regression Detected?}
+    C -- No Fault --> D[System Operational]
+    C -- Yes --> E[Step 3: Execute Safety Rollback]
+    E --> F[Step 4: Verify Post-Restore Health]
+    F --> G[Log Post-Mortem & Fix Root Cause]
+\`\`\`
+
+### Step 1: System Healthcheck
+Initiate diagnostics by checking the operational status of both the Home Assistant Core API and the AI Addon helper daemon.
+- Use \`ha_system_health\` to evaluate connectivity, component reachability, and API response latencies.
+- Determine whether Home Assistant is running in normal, degraded, or recovery state.
+
+\`\`\`json
+// Example call: ha_system_health
+{}
+\`\`\`
+
+### Step 2: Tail & Analyze Sanitized Logs
+Inspect system logs to identify tracebacks, deprecation warnings, unhandled exceptions, template rendering faults, or integration connection failures.
+- Use \`ha_system_get_logs\` specifying \`lines_count\` (e.g. 50-200 lines) and optionally \`source\` (\`core\`, \`supervisor\`, \`all\`).
+- Note: System logs are automatically sanitized by the Addon backend to redact sensitive tokens, passwords, and authorization headers.
+- Categorize observed errors:
+  - **YAML / Syntax Errors**: Invalid keys, missing indentation, or schema validation failures in \`configuration.yaml\`, \`automations.yaml\`, or dashboards.
+  - **Entity / Device Unavailable**: Missing integrations, offline Zigbee/Z-Wave nodes, or changed entity IDs.
+  - **Service Call Failures**: Invocation of nonexistent services or missing target parameters.
+
+\`\`\`json
+// Example call: ha_system_get_logs
+{
+  "lines_count": 100,
+  "source": "all"
+}
+\`\`\`
+
+### Step 3: Execute Safety Rollback or Manual Backup
+When an edit, automation change, or dashboard update leads to instability, regression, or syntax errors, perform an immediate safety rollback.
+- If performing experimental diagnostics before a fix, create a pre-fix checkpoint using \`ha_system_create_backup\` with a descriptive \`label\`.
+- If an issue was introduced by a previous tool call, locate the corresponding \`snapshot_id\` from the tool response or snapshot history.
+- Use \`ha_system_restore_backup\` with \`snapshot_id\` to restore the file atomically. The Addon automatically creates a safety backup of current disk state before restoring.
+
+\`\`\`json
+// Example call: ha_system_create_backup
+{
+  "label": "Pre-troubleshooting configuration checkpoint"
+}
+
+// Example call: ha_system_restore_backup
+{
+  "snapshot_id": "snap_20260831_093000_automations_yaml"
+}
+\`\`\`
+
+### Step 4: Verify Post-Restore System Health
+After executing a rollback or applying a corrective patch, verify that the system has returned to full operational capacity.
+- Re-run \`ha_system_health\` to verify that API and daemon health check reports are \`ok\`.
+- Tail recent logs with \`ha_system_get_logs\` to ensure error loops and exception tracebacks have cleared.
+
+\`\`\`json
+// Example call: ha_system_health
+{}
+
+// Example call: ha_system_get_logs
+{
+  "lines_count": 50
+}
+\`\`\`
+
+---
+
+## Tool Reference
+
+| Tool | Purpose | Key Parameters |
+| :--- | :--- | :--- |
+| \`ha_system_health\` | Query HA Core API & Addon daemon health | *(none)* |
+| \`ha_system_get_logs\` | Fetch sanitized tail of HA core & supervisor logs | \`lines_count\`, \`source\` |
+| \`ha_system_create_backup\` | Create named manual snapshot backup | \`label\` |
+| \`ha_system_restore_backup\` | Restore configuration from snapshot ID | \`snapshot_id\` |
+
+---
+
+## Safety Rules & Best Practices
+
+1. **Non-Destructive Restoration**: All restore operations conducted via \`ha_system_restore_backup\` automatically preserve the overwritten version in a safety snapshot.
+2. **Sanitized Output Awareness**: \`ha_system_get_logs\` redacts secrets; never attempt to bypass log sanitization to inspect raw credentials.
+3. **Rollback Over Patching Broken States**: When an unverified configuration breaks critical automations, roll back to the last known good snapshot before attempting redesigns.
+4. **Mandatory Post-Restore Verification**: Always verify both \`ha_system_health\` and \`ha_system_get_logs\` after any restore or configuration repair.
+`
+};
+
+export function getTargetSkillsDirectories(customDir?: string): string[] {
+  if (customDir) {
+    return [path.resolve(customDir)];
+  }
+
+  const homedir = os.homedir();
+  const candidates: string[] = [];
+
+  const geminiSkills = path.join(homedir, ".gemini", "config", "skills");
+  if (fs.existsSync(geminiSkills)) {
+    candidates.push(geminiSkills);
+  }
+
+  const claudeSkills = path.join(homedir, ".claude", "skills");
+  if (fs.existsSync(claudeSkills)) {
+    candidates.push(claudeSkills);
+  }
+
+  const opencodeSkills = path.join(homedir, ".opencode", "skills");
+  if (fs.existsSync(opencodeSkills)) {
+    candidates.push(opencodeSkills);
+  }
+
+  // If none exist, default to gemini skills path
+  if (candidates.length === 0) {
+    candidates.push(geminiSkills);
+  }
+
+  return candidates;
+}
+
+export function syncSkills(customDir?: string, silent = false): { installedCount: number; targetDirs: string[] } {
+  const targetDirs = getTargetSkillsDirectories(customDir);
+  let installedCount = 0;
+
+  for (const baseDir of targetDirs) {
+    if (!fs.existsSync(baseDir)) {
+      try {
+        fs.mkdirSync(baseDir, { recursive: true });
+      } catch {
+        continue;
+      }
+    }
+
+    for (const [skillName, content] of Object.entries(EMBEDDED_SKILLS)) {
+      try {
+        const skillDir = path.join(baseDir, skillName);
+        if (!fs.existsSync(skillDir)) {
+          fs.mkdirSync(skillDir, { recursive: true });
+        }
+        const skillPath = path.join(skillDir, "SKILL.md");
+        fs.writeFileSync(skillPath, content, "utf8");
+        installedCount++;
+        if (!silent) {
+          console.log(`✓ Synchronized skill: ${skillName} -> ${skillPath}`);
+        }
+      } catch (err: any) {
+        if (!silent) {
+          console.warn(`⚠️ Failed writing skill ${skillName} to ${baseDir}:`, err.message);
+        }
+      }
+    }
+  }
+
+  return { installedCount, targetDirs };
+}

package/src/index.ts

@@ -48,10 +48,29 @@ export function createServer(providedClients?: ToolClients): {
   return { server, clients };
 }
 
-// Backward-compatible alias
-export const createMcpServer = createServer;
+import { syncSkills } from "./cli/skills.js";
+
+export { syncSkills };
 
 async function main(): Promise<void> {
+  const args = process.argv.slice(2);
+  if (args.includes("install-skills") || args.includes("update-skills") || args.includes("sync-skills")) {
+    const customDir = args.find((a) => a.startsWith("--dir="))?.split("=")[1];
+    console.log("🚀 Synchronizing Home Assistant AI Skills...");
+    const result = syncSkills(customDir, false);
+    console.log(`✨ Successfully synchronized ${result.installedCount} skill files across ${result.targetDirs.length} directories.`);
+    process.exit(0);
+  }
+
+  // Background auto-sync skills if enabled or if standard skills folder exists
+  if (process.env.AUTO_SYNC_SKILLS !== "false") {
+    try {
+      syncSkills(undefined, true);
+    } catch {
+      // Non-blocking auto-sync
+    }
+  }
+
   const { server, clients } = createServer();
   const transport = new StdioServerTransport();