Bear Stone Smart Home Documentation

Be sure to :star: my configuration repo so you can keep up to date on any daily progress!

Home Assistant Codex Skills

Reusable Codex skills for designing, validating, documenting, and diagramming Home Assistant and self-hosted infrastructure.

These skills grew out of the public Bear Stone Home Assistant configuration. They are maintained separately so people can install only the automation guidance they need, report issues, and contribute improvements without cloning a full Home Assistant configuration.

Included skills

Skill	Purpose
homeassistant-dashboard-designer	Design and refactor Lovelace YAML with constrained layouts, reusable templates, and validation.
homeassistant-yaml-dry-verifier	Detect duplicated Home Assistant triggers, conditions, actions, sequences, and misplaced shared scripts.
infrastructure-doc-sync	Keep infrastructure instructions, README files, runbooks, dashboards, and inventory snapshots aligned.
network-architecture-diagrammer	Create Mermaid-first Home Assistant and homelab diagrams that import cleanly into Excalidraw.

Install

Clone the repository:

git clone https://github.com/CCOSTAN/Home-Assistant-Codex-Skills.git

Copy the skill folders you want into a Codex skills directory:

• User-wide on Linux/macOS: $HOME/.agents/skills/<skill-name>/
• User-wide on Windows: %USERPROFILE%\.agents\skills\<skill-name>\
• Repository-scoped: <repo>/.agents/skills/<skill-name>/

Each installed folder must contain its own SKILL.md. Restart Codex or begin a new session after installing so the skill catalog is refreshed.

Example for Linux/macOS:

cp -R Home-Assistant-Codex-Skills/homeassistant-yaml-dry-verifier "$HOME/.agents/skills/"

Example for PowerShell:

Copy-Item -Recurse Home-Assistant-Codex-Skills\homeassistant-yaml-dry-verifier "$env:USERPROFILE\.agents\skills\"

You can also invoke $skill-installer and ask it to install one or more skill folders from this GitHub repository.

Use

Invoke an installed skill by name, for example:

$homeassistant-yaml-dry-verifier check the packages I changed and report duplicated automation logic

Read the selected skill's SKILL.md for its workflow and optional tooling. The Python validators use the standard library plus PyYAML where noted.

Validator CLI examples

Validate a Lovelace view:

python homeassistant-dashboard-designer/scripts/validate_lovelace_view.py /path/to/changed-view.yaml

Scan Home Assistant YAML for duplicated logic:

python homeassistant-yaml-dry-verifier/scripts/verify_ha_yaml_dry.py /path/to/config/packages --strict

Validate Mermaid before importing it into Excalidraw:

python network-architecture-diagrammer/scripts/validate_mermaid_excalidraw.py /path/to/diagram.mmd

Walkthroughs and related projects

• Dashboard design walkthrough:
• Dashboard design companion post:
• Example Home Assistant configuration: CCOSTAN/Home-AssistantConfig
• More Home Assistant articles: vCloudInfo Home Assistant
• Videos: vCloudInfo on YouTube

Contributing

Issues and pull requests are welcome. See CONTRIBUTING.md for validation and public-content requirements.

This repository intentionally excludes personal runtime data, credentials, internal hostnames, private infrastructure addresses, and machine-specific agent instruction files.

License

Released under the MIT License.