# Addon Validate > Validate a Home Assistant add-on change with config checks, hadolint, and build prechecks. Use for Dockerfile/config/build updates in hassio-addons. Use when this capability is needed. - Skill: `tomevault-io/addon-validate` (Agent Skill, multi-file: 2 files) - Install (CLI): `npx skillmds@latest add tomevault-io/addon-validate` - Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/addon-validate/raw - Safety review: pending - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Coding & Dev Tools - Author: tomevault-io (https://skillmd.com/u/tomevault-io) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/tomevault-io/addon-validate --- # Add-on Validation Workflow ## When To Use Use this skill when a task changes any of the following: - `config.yaml` or `config.json` - `Dockerfile` - startup/service scripts under `rootfs/` - build metadata (`build.yaml`, image tags, architecture list) ## Procedure 1. Confirm target add-on directory exists and contains `config.yaml` or `config.json`. 2. Initialize submodules: - `git submodule update --init --recursive` 3. Validate config format: - YAML add-on: `yq -e '.name, .version, .arch, .image' /config.yaml` - JSON add-on: `jq -e '.name, .version, .arch' /config.json` 4. Lint Dockerfile: - `hadolint -c /.hadolint.yaml /Dockerfile` 5. Run local build precheck (example single arch): - `check=no archs=--aarch64 ./build.sh ` ## Critical Guardrails - Do not cancel builder runs once started. - Build and image pull phases can take 15-45 minutes per architecture. - Prefer 60+ minute timeouts for build commands. ## Completion Checklist - Config validation passed. - Dockerfile lint passed. - Build command executed or a blocker is clearly reported. - Related docs in the same add-on are updated when behavior changed. --- > Source: [dianlight/hassio-addons](https://github.com/dianlight/hassio-addons) — distributed by [TomeVault](https://tomevault.io).