ha-bubble-dashboard — v1.3 Release Notes
2026-06-05
What this release is
A structural optimisation release. No new features, no behaviour changes — same content, significantly leaner token footprint.
The skill now loads 57% fewer tokens on every request by reorganising content from always-in-context to on-demand reference loading. SKILL.md went from 2162 to 937 lines. Everything that was removed from it is still there — it just lives in a reference file that Claude reads when that specific task arises.
Why it matters
Skills loaded into a Claude Project are always in context. Every token in SKILL.md costs context window on every single message — including messages that have nothing to do with full dashboard generation, health checks, or typography. v1.3 moves the heavy content to reference files so that a simple "add a cover card" request doesn't carry the weight of a 400-line health-check mode it will never use.
What changed
Two new reference files
health-check-ref.md
The full health-check mode (§9) extracted into its own file. Contains the structured parse template (5 steps), all structural pattern examples with correct/wrong YAML, colour scan rules, entity scan rules, engagement-type mixing detection, finding categories with severity tables, output format, tone guides for automate-first findings, and partial YAML handling. SKILL.md §9 is now a 3-line pointer.
recipes-5view.md
Recipes 7–14 extracted from recipes-extended.md into a dedicated 5-view recipes file. Contains the outer scaffold (R7) and per-view card YAML for all five standard views (R8–R12) plus the Energy and Music extension views (R13–R14). Only loaded when generating a full 5-view dashboard.
recipes-extended.md restructured
Now contains: room-specific pop-up patterns (security, vacuum, presence, bathroom, garage, office, Streamline templates) + core Recipes 1–6 (room pop-up, HBS, media player, climate, chip bar, Streamline). The 5-view recipes (R7–R14) have moved to recipes-5view.md.
Content gaps filled (found during cross-check)
Two pieces of content were referenced in SKILL.md stubs but missing from the target reference files:
- Font-only update variable list — the complete set of
ha-font-family-*,paper-font-*, andprimary-font-familyvariables needed for a font-only theme diff. Added totypography-ref.md#font-only-update. - Streamline two-block delivery format — the labelled Block 1 (template) / Block 2 (usage) structure with examples. Added to
streamline-ref.md#delivery-format.
SKILL.md internal cleanup
- §2 UX Principles: lookup tables and reference diagrams moved to
dashboard-system.md; behavioural principles (automate-first, engagement-type model) kept in-context - §3b, §5, §6 compressed to route-only stubs — detail already existed in
typography-ref.md,sidebar-ref.md,streamline-ref.md - §8 pitfalls: 4 entries removed (direct repeats of Iron Law); cross-skill handoffs condensed to a table; performance notes moved to
bubble-card-ref.md - Stale text corrected throughout
Minor fixes
- Recipe 1–6 anchor format standardised from inline
{#anchor}to## #anchor— consistent with all other anchors in the skill - README file tree updated to reflect actual file structure
- Version metadata bumped to
1.3
Upgrading
If you use Option B (files uploaded to a Claude Project):
Replace all uploaded files with the v1.3 versions. The two new files (health-check-ref.md, recipes-5view.md) need to be added as new uploads. Remove the old recipes-extended.md and upload the new one.
If you use Option A (on-disk with system prompt):
Replace the ha-bubble-dashboard/ folder contents. The available-skills-entry.md is unchanged — no system prompt update needed.
File count
20 files → 22 files (added health-check-ref.md, recipes-5view.md)