Agent skill

Health Connect

by androidx in androidx/androidx

Comprehensive guide for Health Connect Jetpack SDK development.

Apache-2.0Auto-check passedMobile

Install Health Connect

skills CLI
$ npx skills add androidx/androidx --skill health-connect -a claude-code

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

GitHub CLI
$ gh skill install androidx/androidx health-connect --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/androidx/androidx.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/health-connect .claude/skills/health-connect && 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
health-connect
GitHub stars
6.1k
Token cost
~1k tokens
SKILL.md length
393 words
Files
1
Skills in repo
6
Repo updated
First seen
Licence
Apache-2.0

At a glance

Comprehensive guide for Health Connect Jetpack SDK development.

  • Works in 5 steps: Development Environment & Workflow → Feature Implementation Workflow → Release Phases (Alpha vs. Beta) → …
  • Modifying any Health Connect APIs in AndroidX
  • SKILL.md covers Overview, 1. Development Environment &…, 2. Feature Implementation… and 3. Release Phases (Alpha vs.…, plus 2 more sections
  • Calls git

What it does

Health Connect is an agent skill from androidx/androidx. Comprehensive guide for Health Connect Jetpack SDK development. Includes AOSP workflow, feature implementation, naming standards, testing, and release phase requirements (Alpha/Beta/Experimental). Use when adding or modifying any Health Connect APIs in AndroidX.

Its SKILL.md is about 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 Mobile. It works with Android. The repository describes itself as: Development environment for Android Jetpack extension libraries under the androidx namespace. Synchronized with Android Jetpack's primary development branch on AOSP. The licence is Apache-2.0.

When your agent uses it

  • Modifying any Health Connect APIs in AndroidX

Example prompts

  • “/health-connect”

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. Development Environment & Workflow
  2. Feature Implementation Workflow
  3. Release Phases (Alpha vs. Beta)
  4. Critical Commands
  5. Testing Standards

What it can do on your machine

Read from SKILL.md and the folder at commit 6c35dc9. 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

    Shell commands in SKILL.md call:

    • git

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

  • Network

    No URLs in SKILL.md. Its commands use git, which can reach the network depending on how they are called.

    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

Health Connect loads about 1k tokens when it runs. Until then it costs about 69 tokens; SKILL.md has 393 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~69
When it runs · the whole SKILL.md, loaded when a task matches
~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 androidx/androidx at commit 6c35dc9, republished under its Apache-2.0 licence (© androidx). 393 words, ~1,040 tokens.

Download SKILL.mdSave it as .claude/skills/health-connect/SKILL.md (or your agent's skills folder).
name
health-connect
description
Comprehensive guide for Health Connect Jetpack SDK development. Includes AOSP workflow, feature implementation, naming standards, testing, and release phase requirements (Alpha/Beta/Experimental). Use when adding or modifying any Health Connect APIs in AndroidX.

Health Connect Jetpack SDK Development

Overview

This skill defines the end-to-end workflow for developing Health Connect features in the AndroidX repository (frameworks/support/health/connect/).

1. Development Environment & Workflow

  • Root Directory: Always work from frameworks/support/.
  • Git Strategy:
    • Start a new branch: repo start <branch_name> .
    • First commit: git commit
    • Subsequent changes: git commit --amend
    • Upload for review: repo upload --cbr .
  • Sync to google3: Submission in AOSP triggers a "Safe Review" CL in Piper via Copybara. Approval in Piper triggers auto-submit and TAP.

2. Feature Implementation Workflow

Step 1: Platform API Availability
  • Ensure backing platform APIs are available. If not, perform a self-service prebuilt drop (go/androidx/playbook/update_sdk).
  • Map the version in HealthConnectFeatures.kt (e.g., Baklava/Android 37 or specific U/V extensions).
Step 2: Define Feature & Versioning
  • Add FEATURE_* constant to HealthConnectFeatures.kt.
  • Update FEATURE_TO_VERSION_INFO_MAP.
  • Access Control: Annotate every new public symbol with @RestrictTo(RestrictTo.Scope.LIBRARY) during development to prevent unintentional release.
Step 3: Implement Models & Client
  • Model Packaging: Create required Request/Response classes in a feature-specific package (e.g., androidx.health.connect.client.<feature_name>). This is the preferred approach for modularity and clarity.
  • Add methods to HealthConnectClient.kt.
  • Intent Constants: Descriptive internal constants (e.g., ACTION_HEALTH_CONNECT_MATCHMAKING) should be used for platform delegation.
Step 4: Logic & Delegation
  • Platform-Only Implementation: New features are developed for the platform (Android U+ / API 34+) using the system service. Do not add new feature logic to the legacy APK-based path (HealthConnectClientImpl.kt).
  • Implement logic in HealthConnectClientUpsideDownImpl.kt.
  • Check platform API availability before calling platform methods; throw UnsupportedOperationException if unavailable.
  • Note: This architectural shift ensures features leverage the system service and modern OS extensions.
Show full SKILL.md (147 more words)Show less

3. Release Phases (Alpha vs. Beta)

Alpha Release
  • Remove @RestrictTo(RestrictTo.Scope.LIBRARY).
  • If the API is still evolving or not ready for final stable release, mark with an experimental annotation (e.g., @ExperimentalMatchmakingApi).
  • Submit for API review (go/hc-jetpack-sdk-review-process).
Beta/RC/Stable Release
  • Experimental Annotation: If the SDK version is Beta, RC, or Stable, new APIs must be marked with an experimental annotation unless they are fully ready for a stable commitment.
  • Remove @RestrictTo only after experimental annotations and API reviews are complete.

4. Critical Commands

TaskCommand
Format./gradlew :ktFormat or ./gradlew :ktCheckFile --format --file <path>
Build./gradlew :health:connect:connect-client:assemble
Update API./gradlew :health:connect:connect-client:updateApi
Unit Test./gradlew :health:connect:connect-client:test
Instrumentation Test./gradlew :health:connect:connect-client:connectedAndroidTest -Pandroid.testInstrumentationRunnerArguments.class=<class>

5. Testing Standards

  • Emulator/Device Tests: Required for platform-delegated APIs. Use real devices or emulators with the latest system images.
  • Suppression:
    • Use assumeTrue(Build.VERSION.SDK_INT >= X) for platform release features.
    • Use assumeTrue(SdkExtensions.getExtensionVersion(Build.VERSION_CODES.U) >= Y) for extension features.
  • Fakes: Always update FakeHealthConnectClient.kt for new APIs.

© androidx, 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/health-connect of androidx/androidx.

Open the folder on GitHubat commit 6c35dc9

Compare with similar skills

Health Connect 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.

Health Connect compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Health Connect this skillandroidx/androidx6.1k—~1kAutomated safety check: PassApache-2.0
Compose Multiplatform Patternsmonta-app/ocpp-emulator1805 repos~2kAutomated safety check: PassApache-2.0
Phone HarnessShawnPana/phone-harness3.2k—~4.3kAutomated safety check: PassMIT
Stylesarindamxd/camerax-android1324 repos~2.3kAutomated safety check: PassApache-2.0
Verified Emailarindamxd/camerax-android1324 repos~4.7kAutomated safety check: PassApache-2.0
Argent Metro Debuggerbbplayer-app/BBPlayer1.2k—~3.4kAutomated safety check: PassMIT

Similar skills

  • Compose Multiplatform Patterns

    monta-app/ocpp-emulator

    Compose Multiplatform and Jetpack Compose patterns for KMP projects — state management, navigation, theming, performance, and platform-specific UI.

    180 GitHub starsUsed in 5 repos~2k tokens
    MobileAuto-check passed
  • Phone Harness

    ShawnPana/phone-harness

    Control the user's phone — an iPhone through the Mac's iPhone Mirroring window, an Android over adb, or a rented cloud Android: open apps, tap, type, swipe, read the screen.

    3.2k GitHub stars~4.3k tokensUpdated today
    MobileAuto-check passed
  • Styles

    arindamxd/camerax-android

    A skill your agent uses to integrate the Jetpack Compose Styles API into an Android project.

    132 GitHub starsUsed in 4 repos~2.3k tokens
    MobileAuto-check passed
  • Verified Email

    arindamxd/camerax-android

    Provides a complete workflow for implementing verified email retrieval on Android Credential Manager API.

    132 GitHub starsUsed in 4 repos~4.7k tokens
    MobileAuto-check passed
  • Argent Metro Debugger

    bbplayer-app/BBPlayer

    Debug a JS runtime via CDP using argent debugger tools. An agent skill from bbplayer-app/BBPlayer.

    1.2k GitHub stars~3.4k tokensUpdated yesterday
    MobileAuto-check passed
  • 统一 Android XML 资源命名:layout、drawable、mipmap、color、values、id 的前缀与 snakecase 规则;把颜色/圆角/描边/状态编码进文件名(bg、border、textcolor…selector)。

    1.6k GitHub stars~1.3k tokensUpdated 1 mo ago
    MobileAuto-check passed

More from androidx/androidx

  • Find My Flags

    androidx/androidx

    A skill your agent uses to find Compose feature flags introduced by a specific git user or email and map them to the library version in which they were added.

    6.1k GitHub stars~664 tokensUpdated today
    Auto-check passed
  • Benchmark

    androidx/androidx

    Benchmarking and improving the performance of Jetpack Compose.

    6.1k GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Remove Feature Flag

    androidx/androidx

    A skill your agent uses to remove a feature flag when the flag is no longer needed and its current state must be made permanent.

    6.1k GitHub stars~1.2k tokensUpdated today
    Auto-check passed
  • Webkit API Development

    androidx/androidx

    Step-by-step guide for implementing AndroidX WebKit APIs in frameworks/support/webkit/ after boundary interface roll.

    6.1k GitHub stars~3.7k tokensUpdated today
    Auto-check passed
  • Compose Catalog

    androidx/androidx

    Build, install, and run the Compose Material Catalog application on connected devices or emulators.

    6.1k GitHub stars~499 tokensUpdated today
    Auto-check passed

Works with

Categories

Questions about Health Connect

What does Health Connect do?

Comprehensive guide for Health Connect Jetpack SDK development. Health Connect is an agent skill from androidx/androidx. Comprehensive guide for Health Connect Jetpack SDK development.

When should I use Health Connect?

Health Connect fits situations like: modifying any Health Connect APIs in AndroidX.

How do I install Health Connect in Claude Code?

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

How do I install Health Connect in Codex?

Run `npx skills add androidx/androidx --skill health-connect -a codex`. Or copy the skill folder (.agents/skills/health-connect in androidx/androidx) into .agents/skills/health-connect in your project. Codex loads it when a task matches its description.

Can I use Health Connect 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 androidx/androidx --skill health-connect -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/health-connect, .gemini/skills/health-connect, .github/skills/health-connect and .opencode/skills/health-connect in your project.

What does Health Connect need to run?

Going by SKILL.md and its folder, Health Connect needs the command-line tools its instructions call (git).

Does Health Connect access the network?

SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Health Connect 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 Health Connect use?

Health Connect 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 Health Connect use?

About 1k tokens (SKILL.md is roughly 4.2k 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 Health Connect?

Skills that share tags, products or a category with Health Connect: Compose Multiplatform Patterns (monta-app/ocpp-emulator, 180 stars), Phone Harness (ShawnPana/phone-harness, 3.2k stars), Styles (arindamxd/camerax-android, 132 stars) and Verified Email (arindamxd/camerax-android, 132 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Health Connect?

androidx (a GitHub organization) maintains it in androidx/androidx, which has 6,107 GitHub stars. The repository holds 6 skills in this directory. The repository was last updated on October 9, 2026.

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