onboarding

Diagnose HA NOVA Relay onboarding, connectivity, and authentication failures.

21|1|Updated Feb 25, 2026
One-click install
npx skills add https://github.com/markusleben/ha-nova --skill onboarding-markusleben
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: onboarding
Source: https://github.com/markusleben/ha-nova/tree/main/skills/onboarding
Command: npx skills add https://github.com/markusleben/ha-nova --skill onboarding-markusleben

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill resolves issues related to the initial setup, network connectivity, and authentication problems that prevent the HA NOVA Relay from functioning correctly.

Core Features & Use Cases

  • Diagnostic Execution: Runs specific checks to identify the root cause of onboarding or connection failures.
  • Targeted Remediation: Provides precise commands to fix identified issues, such as token mismatches or unreachable relays.
  • Use Case: If your HA NOVA Relay is not connecting to Home Assistant, you can use this skill to diagnose the problem and get a command to re-establish the connection.

Quick Start

Use the onboarding skill to run a quick health check on the HA NOVA relay.

Frequently Asked Questions about onboarding

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I fix HA NOVA Relay connection issues with Home Assistant?

You fix HA NOVA Relay connection issues by running diagnostic npm scripts to identify unhealthy upstream WebSocket connections or token mismatches, then applying targeted remediation commands to restore connectivity with Home Assistant.

Why does my HA NOVA Relay show an authentication failure during onboarding?

HA NOVA Relay authentication failures during onboarding often stem from token mismatches. Running detailed diagnostic scripts helps identify these specific mismatches and provides precise commands to resolve the credential errors.

How do I run a health check on my HA NOVA Relay setup?

You run a health check on your HA NOVA Relay setup by executing specific npm scripts designed to diagnose connectivity and authentication status, which outputs detailed diagnostic information to pinpoint any upstream WebSocket issues.

What should I do when my HA NOVA Relay is unreachable?

When your HA NOVA Relay is unreachable, use diagnostic scripts to evaluate network connectivity and upstream WebSocket health. The diagnostics output concrete remediation steps to re-establish the relay connection.

Do I need npm scripts to troubleshoot HA NOVA Relay onboarding problems?

Yes, troubleshooting HA NOVA Relay onboarding problems requires specific npm scripts to perform health checks and detailed diagnostics, which then identify the exact connectivity or authentication failures needing remediation.