Agent skill

Ha Frontend Events

by home-assistant in home-assistant/frontend

Home Assistant frontend event patterns. An agent skill from home-assistant/frontend.

Apache-2.0Auto-check passedFrontend & Design

Install Ha Frontend Events

skills CLI
$ npx skills add home-assistant/frontend --skill ha-frontend-events -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install home-assistant/frontend ha-frontend-events --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/home-assistant/frontend.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/ha-frontend-events .claude/skills/ha-frontend-events && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
ha-frontend-events
GitHub stars
5.7k
Token cost
~1.1k tokens
SKILL.md length
330 words
Files
1
Skills in repo
12
Repo updated
First seen
Licence
Apache-2.0

At a glance

Home Assistant frontend event patterns. An agent skill from home-assistant/frontend.

  • Typing event handlers
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Using HASSDomEvent types
  • Dispatching with fireEvent

What it does

Ha Frontend Events is an agent skill from home-assistant/frontend. Home Assistant frontend event patterns. Use when typing event handlers, using HASSDomEvent types, dispatching with fireEvent, or declaring HASSDomEvents and event maps.

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Frontend & Design. It works with Home Assistant. The repository describes itself as: :lollipop: Frontend for Home Assistant. The licence is Apache-2.0.

When your agent uses it

  • Typing event handlers
  • Using HASSDomEvent types
  • Dispatching with fireEvent
  • Declaring HASSDomEvents and event maps

Example prompts

  • “/ha-frontend-events”

What it can do on your machine

Read from SKILL.md and the folder at commit 3280113. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are typescript).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Ha Frontend Events loads about 1.1k tokens when it runs. Until then it costs about 47 tokens; SKILL.md has 330 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~47
When it runs · the whole SKILL.md, loaded when a task matches
~1.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from home-assistant/frontend at commit 3280113, republished under its Apache-2.0 licence (© home-assistant). 330 words, ~1,086 tokens.

Download SKILL.mdSave it as .claude/skills/ha-frontend-events/SKILL.md (or your agent's skills folder).
name
ha-frontend-events
description
Home Assistant frontend event patterns. Use when typing event handlers, using HASSDomEvent types, dispatching with fireEvent, or declaring HASSDomEvents and event maps.

HA Frontend Events

Use this skill when implementing or reviewing event listeners and custom event contracts. Cross-load ha-frontend-components when the work also involves dialogs, forms, alerts, shortcuts, tooltips, panels, Lovelace cards, or buttons.

Event Handling

Use the event types from src/common/dom/fire_event.ts instead of plain Event, generic CustomEvent, or element casts when they express the handler contract:

  • Use HASSDomCurrentTargetEvent<T> to read the element on which the listener was registered through ev.currentTarget.
  • Use HASSDomTargetEvent<T> only to read the element that originated the event through ev.target.
  • Use HASSDomEvent<T> to read a custom event payload through ev.detail.
  • Use ValueChangedEvent<T> from src/types.ts for the standard value-changed event.
  • Prefer an event type exported by the component being listened to, such as HaSelectSelectEvent<T, Clearable> or HaDropdownSelectEvent<TValue, TData>, over reconstructing its detail type.
  • Use ActionHandlerEvent from src/data/lovelace/action_handler.ts for Lovelace tap, hold, and double-tap handlers.

Import event and element types with import type:

ts
import type {
  HASSDomCurrentTargetEvent,
  HASSDomEvent,
  HASSDomTargetEvent,
} from "../common/dom/fire_event";
import type { HaCheckbox } from "../components/ha-checkbox";
import type { HaEntityPicker } from "../components/entity/ha-entity-picker";
import type { HaRadioGroup } from "../components/radio/ha-radio-group";
import type { ValueChangedEvent } from "../types";

Type the handler so the selected property can be read directly. Do not cast ev.currentTarget or assign it to a single-use variable:

ts
private _scopeChanged(ev: HASSDomCurrentTargetEvent<HaRadioGroup>): void {
  this._scope = ev.currentTarget.value;
}

private _checkedChanged(ev: HASSDomTargetEvent<HaCheckbox>): void {
  this._checked = ev.target.checked;
}

private _valueChanged(ev: ValueChangedEvent<string>): void {
  this._value = ev.detail.value;
}

private _itemSelected(ev: HASSDomEvent<{ id: string }>): void {
  this._selectedId = ev.detail.id;
}

Use intersections when a handler needs more than one facet of an event. Keep the native event type when the handler reads native fields such as key, modifier keys, dataTransfer, or focus relationships:

ts
private _entityChanged(
  ev: ValueChangedEvent<string> & HASSDomCurrentTargetEvent<HaEntityPicker>
): void {
  ev.currentTarget.value = ev.detail.value;
}

private _keyDown(
  ev: KeyboardEvent & HASSDomCurrentTargetEvent<HTMLInputElement>
): void {
  if (ev.key === "Enter") {
    this._submit(ev.currentTarget.value);
  }
}

Dispatch Home Assistant component events with fireEvent() instead of constructing Event or CustomEvent directly. Register the event name and detail type by augmenting HASSDomEvents; use undefined when an event has no detail. fireEvent() constrains event names and supplied detail, and events bubble and cross shadow boundaries by default:

ts
fireEvent(this, "item-selected", { id: item.id });
fireEvent(this, "refresh-requested");

When an event is already registered, derive handler and listener types from its registration rather than repeating the payload shape:

ts
private _itemSelected(
  ev: HASSDomEvent<HASSDomEvents["item-selected"]>
): void {
  this._selectedId = ev.detail.id;
}

HASSDomEvents types fireEvent() calls. Augment HTMLElementEventMap for typed listeners on HTML elements, or GlobalEventHandlersEventMap when the event is handled on global event targets.

In component files, prefer placing global event declarations after the class at the bottom of the file. Preserve the existing placement when editing established files; foundational type, helper, and mixin files commonly keep declarations near the top before their consumers.

ts
declare global {
  interface HASSDomEvents {
    "item-selected": { id: string };
    "refresh-requested": undefined;
  }

  interface HTMLElementEventMap {
    "item-selected": HASSDomEvent<HASSDomEvents["item-selected"]>;
  }
}

© home-assistant, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .agents/skills/ha-frontend-events of home-assistant/frontend.

Open the folder on GitHubat commit 3280113

Compare with similar skills

Ha Frontend Events next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Ha Frontend Events compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Ha Frontend Events this skillhome-assistant/frontend5.7k—~1.1kAutomated safety check: PassApache-2.0
Sap Extension Creatorheshengtao/super-agent-party2.7k—~6kAutomated safety check: PassAGPL-3.0
Develop Big Slider Cardnicufarmache/lovelace-big-slider-card104—~1.4kAutomated safety check: PassMIT
Hass Synchomeassistant-extras/device-card131—~1.4kAutomated safety check: PassMIT
Ha Android UIhome-assistant/android4k—~1.5kAutomated safety check: PassApache-2.0
Implement Widget Frontendcryptomilk/hass-eink-dashboard116—~3.3kAutomated safety check: PassApache-2.0

Similar skills

  • Sap Extension Creator

    heshengtao/super-agent-party

    Create Super Agent Party (SAP) extensions. An agent skill from heshengtao/super-agent-party.

    2.7k GitHub stars~6k tokensUpdated yesterday
    Frontend & DesignAuto-check passed
  • Develop Big Slider Card

    nicufarmache/lovelace-big-slider-card

    Implement, fix, extend, or review the Big Slider Card Home Assistant custom card.

    104 GitHub stars~1.4k tokensUpdated 1 mo ago
    Frontend & DesignAuto-check passed
  • Hass Sync

    homeassistant-extras/device-card

    Maintains synchronization between src/hass folder and Home Assistant frontend source code.

    131 GitHub stars~1.4k tokensUpdated 4 days ago
    Frontend & DesignAuto-check passed
  • Ha Android UI

    home-assistant/android

    Home Assistant Android UI guidance. An agent skill from home-assistant/android.

    4k GitHub stars~1.5k tokensUpdated yesterday
    MobileAuto-check passed
  • Implement Widget Frontend

    cryptomilk/hass-eink-dashboard

    Add TypeScript types in ha.d.ts and editor schema in eink-dashboard-editor.ts for a new or updated widget type; also handles deprecating an old type (remove from picker, keep schema, add @deprecated…

    116 GitHub stars~3.3k tokensUpdated 5 days ago
    DevelopmentAuto-check passed
  • Translations

    jtenniswood/espcontrol

    Find static user-visible words shown on the physical EspControl device and integrate them into the firmware translation process.

    1.1k GitHub stars~2.2k tokensUpdated today
    Writing & ContentAuto-check passed

More from home-assistant/frontend

All 12 skills in this repo
  • Ha Frontend Components

    home-assistant/frontend

    Home Assistant frontend component patterns. An agent skill from home-assistant/frontend.

    5.7k GitHub stars~1.2k tokensUpdated today
    Auto-check passed
  • Ha Frontend Contexts

    home-assistant/frontend

    Home Assistant frontend Lit context and hass migration guidance.

    5.7k GitHub stars~1.9k tokensUpdated today
    Auto-check passed
  • Ha Frontend Demo

    home-assistant/frontend

    Home Assistant standalone demo structure, configurations, URL navigation, mocked APIs, shared demo stubs used by gallery, and verification.

    5.7k GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Ha Frontend Gallery

    home-assistant/frontend

    Home Assistant frontend gallery structure, pages, demos, content, and verification.

    5.7k GitHub stars~2k tokensUpdated today
    Auto-check passed
  • Ha Frontend Styling

    home-assistant/frontend

    Home Assistant frontend styling, theming, spacing, responsive layout, RTL, and View Transitions guidance.

    5.7k GitHub stars~799 tokensUpdated today
    Auto-check passed
  • Ha Frontend Testing

    home-assistant/frontend

    Home Assistant frontend testing and validation workflow. An agent skill from home-assistant/frontend.

    5.7k GitHub stars~1.7k tokensUpdated today
    Auto-check passed

Works with

Questions about Ha Frontend Events

What does Ha Frontend Events do?

Home Assistant frontend event patterns. An agent skill from home-assistant/frontend. Ha Frontend Events is an agent skill from home-assistant/frontend. Home Assistant frontend event patterns.

When should I use Ha Frontend Events?

Ha Frontend Events fits situations like: typing event handlers; using HASSDomEvent types; dispatching with fireEvent; declaring HASSDomEvents and event maps.

How do I install Ha Frontend Events in Claude Code?

Run `npx skills add home-assistant/frontend --skill ha-frontend-events -a claude-code`. Or copy the skill folder (.agents/skills/ha-frontend-events in home-assistant/frontend) into .claude/skills/ha-frontend-events in your project. Claude Code loads it when a task matches its description.

How do I install Ha Frontend Events in Codex?

Run `npx skills add home-assistant/frontend --skill ha-frontend-events -a codex`. Or copy the skill folder (.agents/skills/ha-frontend-events in home-assistant/frontend) into .agents/skills/ha-frontend-events in your project. Codex loads it when a task matches its description.

Can I use Ha Frontend Events in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add home-assistant/frontend --skill ha-frontend-events -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/ha-frontend-events, .gemini/skills/ha-frontend-events, .github/skills/ha-frontend-events and .opencode/skills/ha-frontend-events in your project.

What does Ha Frontend Events need to run?

SKILL.md names no scripts, command-line tools or credentials: Ha Frontend Events is instructions for the agent only.

Does Ha Frontend Events access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Ha Frontend Events safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Ha Frontend Events use?

Ha Frontend Events is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Ha Frontend Events use?

About 1.1k tokens (SKILL.md is roughly 4.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Ha Frontend Events?

Skills that share tags, products or a category with Ha Frontend Events: Sap Extension Creator (heshengtao/super-agent-party, 2.7k stars), Develop Big Slider Card (nicufarmache/lovelace-big-slider-card, 104 stars), Hass Sync (homeassistant-extras/device-card, 131 stars) and Ha Android UI (home-assistant/android, 4k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Ha Frontend Events?

home-assistant (a GitHub organization) maintains it in home-assistant/frontend, which has 5,699 GitHub stars. The repository holds 12 skills in this directory. The repository was last updated on October 11, 2026.

Source: home-assistant/frontend on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.