ha-android-committing

Home Assistant Android change finalization. Use when finishing a change, preparing to commit, updating the changelog, naming a branch, or opening a pull request.

Jump to install

Repository: home-assistant/android
Last source activity: August 26, 2026 at 16:10
Detected SKILL.md language: English
Stars: 3,842
Forks: 1,047

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

A direct command skips the review prompt. Inspect the source before running it.

npx skills add https://github.com/home-assistant/android --skill ha-android-committing

The command stays on one line. Scroll horizontally to inspect it before copying.

Prefer a local copy? Download the files currently available to SkillsMP.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

SKILL.md

Source instructions · Read-only preview

Back to search Back to installation

ha-android-testing

Home Assistant Android testing guidance. Use when writing or reviewing unit tests, Robolectric tests, Flow tests with Turbine, screenshot tests, fakes from testing-unit, or module-wide test rules.

2026-07-22

ha-android-architecture

Home Assistant Android module and layer architecture. Use when adding features, choosing where code lives, writing repositories or use cases, setting up Hilt injection, storing data securely, or calling Home Assistant APIs.

2026-07-13

ha-android-concurrency

Home Assistant Android coroutine and threading guidance. Use when launching coroutines, choosing dispatchers, sharing mutable state across threads, exposing Flows, or reviewing for blocking calls and race conditions.

2026-07-13

View all from this repository

HA Android Committing

Use this skill when finalizing a change and preparing it for commit or a pull request. For evaluating the code itself, use the ha-android-review skill.

Before Committing

Format: ./gradlew :build-logic:convention:ktlintFormat ktlintFormat

Tests: ./gradlew test

If the change adds a feature or changes behavior visibly for end users, add it to app/src/main/kotlin/io/homeassistant/companion/android/changelog/ChangelogContent.kt. Small bug fixes don't get their own entry — the standing "Bug fixes and dependency updates" entry already covers them.

After adding or updating any dependency (in gradle/libs.versions.toml or module declarations), run ./gradlew alldependencies --write-locks.

Run the ha-android-review skill over the diff before handing it off.

Branch naming: feature/add-dark-mode, fix/crash-on-rotation.

Pull Requests

Use .github/pull_request_template.md as the PR body.

Keep PRs small — easier to review, faster to merge. Break large changes into logical chunks; a reusable component (a new HA* composable, a shared utility) deserves its own PR before the feature that uses it.

A PR must not contain changes unrelated to its purpose. Found a bug on the way? Open an issue and a separate PR. Revert incidental edits to files the change doesn't need.

Pure refactor or code-move PRs must not change behavior — keep copied code as it was and fix pre-existing issues in follow-ups.

Once a PR is open, merge main into the branch instead of rebasing.

Keep the PR description and screenshots up to date as the implementation evolves.

Tests belong in the same PR as the implementation they cover, including tests moved along with moved logic.

Features visible in :app must be verified on (or hidden from) Automotive and other form factors like Meta Quest.

When the Android Gradle Plugin is updated, refresh the lint baseline with ./gradlew updateLintBaseline. Never grow the baseline to silence an issue introduced by your change — fix the source or delete the unused resource instead.