Skip to content

Claude skill library for building Home Assistant dashboards with Bubble Card, Streamline Card, Sidebar Card, and Mushroom Cards

Choose a tag to compare

@johnnyh1975 johnnyh1975 released this 29 May 10:17
· 5 commits to main since this release
a9fc6d8

v1.0 — Initial public release

This is the first public release of HA_Bubble_Skill — a Claude skill library for building Home Assistant dashboards with Bubble Card, Streamline Card, Sidebar Card, and Mushroom Cards.


What's included

16 files across three folders:

  • SKILL.md — the main skill file with iron laws, process flow, UX principles, installation guide, eight content sections, pre-output checklist, and cross-skill handoffs
  • references/ — 11 reference files covering every card type, the full CSS theme variable catalogue, colour intelligence with palette recipes, Mushroom ↔ HA integration, typography, troubleshooting, and extended room recipes
  • theme/Casa5HeyneV2.yaml — the base HA theme with full Bubble Card and Mushroom state-colour integration, six palette zones, light and dark mode

Key capabilities

  • Bubble Card 3.2.x — all card types documented with version compatibility flags; v3.2 standalone pop-up format enforced
  • Merged CSS theme--bubble-* variables chain to HA variables; Mushroom entity-domain state colours wired via ZONE 6 bridge; single accent change repaints the entire UI
  • Colour intelligence — 6 accent swap recipes, 6 full palette recipes, WCAG contrast pre-flight, advisory and prescriptive modes, bring-your-own-hex template
  • Typography — three font loading methods (CDN, self-hosted variable font, system stack), wall-panel size overrides, four ready-made font swap recipes
  • Single-mode themes — wall-panel and kiosk support; light-only or dark-only theme generation with HA mode-selection explanation
  • Mushroom chip cards — full chip type documentation including template chip with Jinja2 icon/colour/content patterns
  • Troubleshooting — 14 symptom sections with cause/fix tables covering every common failure mode
  • Test dashboard — importable Lovelace YAML assembling core recipes; works in both UI-mode and YAML-mode Lovelace

Two usage modes

On disk (Claude computer-use, Claude Code, custom system prompt): place the skill folder at /mnt/skills/user/HA_Bubble_Skill/ and paste available-skills-entry.md into your <available_skills> system prompt block. Claude loads the skill automatically when it detects relevant requests.

Uploaded to Claude (claude.ai Projects): upload all .md files and references/casa5heynev2-template.yaml as project knowledge. Skip available-skills-entry.md — it is not needed when files are uploaded directly.


Component versions pinned

Component Version
Bubble Card 3.2.2
Bubble Card Tools 1.0.2
Streamline Card 0.2.2
Sidebar Card 0.1.9.9
HA minimum 2024.3.0