hal-vendor-interface-expert

Align Android HAL binder domains, VNDK boundaries, and service registration to verified AIDL definitions.

40|7|Updated Mar 14, 2026
One-click install
npx skills add https://github.com/jonaschen/Android-Software --skill hal-vendor-interface-expert
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hal-vendor-interface-expert
Source: https://github.com/jonaschen/Android-Software/tree/main/skills/L2-hal-vendor-interface-expert
Command: npx skills add https://github.com/jonaschen/Android-Software --skill hal-vendor-interface-expert

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Provides a dedicated HAL expertise layer to prevent misrouted binder calls, frozen interface violations, and VNDK/Treble breaches when working across Android system, vendor, and interface boundaries.

Core Features & Use Cases

  • Path Scope Awareness: Covers hardware/interfaces/, vendor OEM directories, system/vndk/, frameworks/native/libs/binder/, and PDK HAL compliance testing to keep HAL changes scoped correctly.
  • Operational Guardrails: Explicit forbidden actions guard the agent from adding new HIDL interfaces, linking vendor modules to non-VNDK libraries, misusing binder domains, or neglecting VINTF manifest declarations.
  • Guided Tooling: Recommends commands to inspect AIDL versions, query registered HALs, check VNDK membership, find VINTF manifests, and regenerate HAL APIs when bumping interface versions.

Quick Start

Ask the agent to inspect hardware/interfaces/aidl and vendor HAL bindings for versioning, binder registration, and VNDK compliance issues.

Frequently Asked Questions about hal-vendor-interface-expert

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I ensure AIDL compliance when adding a new Android HAL interface?

To ensure AIDL compliance when adding an Android HAL interface, you must align binder domains, VNDK boundaries, and service registration with verified AIDL definitions. This process involves checking VINTF manifest declarations and frozen Android.bp versions to prevent interface violations.

Why are my vendor binder calls misrouted during a HAL migration?

Vendor binder calls are misrouted during HAL migration due to misaligned binder domains and incorrect VNDK boundary scoping. Resolving this requires inspecting AIDL versions, querying registered HALs, and enforcing binder domain restrictions across hardware/interfaces/ and vendor directories.

How do I check VNDK membership for vendor modules linking non-VNDK libraries?

You can check VNDK membership for vendor modules by using guided tooling commands to inspect the system/vndk/ directory. This prevents Treble breaches by explicitly forbidding vendor modules from linking to non-VNDK libraries during HAL development.

What is the best way to declare VINTF manifests for Treble compliance?

The best way to declare VINTF manifests for Treble compliance is to use targeted commands to find VINTF manifests and verify them against frozen interface versions. This ensures hardware and vendor interface boundaries remain strictly scoped and compliant.

Can I add new HIDL interfaces when migrating Android HALs?

You cannot add new HIDL interfaces when migrating Android HALs because operational guardrails explicitly forbid this action. You must instead align with verified AIDL definitions and regenerate HAL APIs when bumping interface versions.

How do I bump interface versions and regenerate HAL APIs in Android.bp?

To bump interface versions and regenerate HAL APIs in Android.bp, you inspect AIDL versions and execute commands to regenerate the APIs. This maintains frozen Android.bp version requirements and ensures VINTF manifest declarations remain valid.