ha-diagnostics

Generate Home Assistant integration diagnostics with sensitive data redaction.

6|1|Updated Feb 16, 2026
One-click install
npx skills add https://github.com/L3DigitalNet/Claude-Code-Plugins --skill ha-diagnostics
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ha-diagnostics
Source: https://github.com/L3DigitalNet/Claude-Code-Plugins/tree/main/plugins/home-assistant-dev/skills/ha-diagnostics
Command: npx skills add https://github.com/L3DigitalNet/Claude-Code-Plugins --skill ha-diagnostics

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps developers and users generate structured diagnostic information for Home Assistant integrations, crucial for troubleshooting and meeting quality standards.

Core Features & Use Cases

  • Generate Diagnostics: Creates detailed debug information for Home Assistant configurations and devices.
  • Redact Sensitive Data: Automatically removes sensitive information like passwords, tokens, and personal details from the output.
  • Device-Specific Info: Optionally includes diagnostics for individual devices managed by an integration.
  • Use Case: When a user reports an issue with a Home Assistant integration, use this skill to gather all relevant logs and configuration details, ensuring sensitive data is protected before sharing with developers.

Quick Start

Use the ha-diagnostics skill to generate diagnostics for the current Home Assistant configuration entry.

Frequently Asked Questions about ha-diagnostics

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

FAQPage Schema
How do I generate diagnostics for a Home Assistant integration?

To generate Home Assistant integration diagnostics, you create a diagnostics configuration that extracts debug information for configurations and devices. This process gathers relevant logs and details to help troubleshoot reported issues effectively.

How does Home Assistant redact sensitive data in diagnostics?

Home Assistant redacts sensitive data in diagnostics by utilizing the `async_redact_data` helper. This mechanism automatically removes passwords, tokens, and personal details from the output, ensuring secure data handling before sharing debug information.

What diagnostics data is needed to meet the Home Assistant Integration Quality Scale?

Meeting the Home Assistant Integration Quality Scale requires generating structured diagnostic information for your integration. This includes supporting basic and advanced scenarios with device registry and entity registry data to ensure comprehensive troubleshooting details.

Can I include device-specific diagnostics for individual devices in Home Assistant?

Yes, you can include device-specific diagnostics for individual devices managed by a Home Assistant integration. This optional feature allows you to gather targeted debug information and configuration details specific to a single device.

What is the best way to securely share Home Assistant integration logs with developers?

The best way to securely share Home Assistant integration logs is to generate diagnostics with automatic redaction. This ensures sensitive information like passwords and tokens is removed from the debug output before sharing the configuration details with developers.