reis-mobile 0.4.0 → 0.5.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "reis-mobile",
-  "version": "0.4.0",
-  "description": "AI agents, skills and workflows for Flutter, Android, iOS and React Native development.",
+  "version": "0.5.0",
+  "description": "AI agents and skills for mobile development — Flutter, Android, iOS and React Native — as a plugin for Claude Code and Codex: code review, debugging, tests, architecture, security and Firebase.",
   "type": "module",
   "license": "MIT",
   "author": "Warleson Reis",
@@ -31,5 +31,26 @@
     "validate": "node bin/reis-mobile.mjs validate",
     "check": "npm run validate && npm test"
   },
-  "keywords": ["mobile", "flutter", "android", "ios", "react-native", "claude-code", "plugin", "agents"]
+  "keywords": [
+    "flutter",
+    "android",
+    "ios",
+    "react-native",
+    "expo",
+    "swift",
+    "swiftui",
+    "kotlin",
+    "jetpack-compose",
+    "dart",
+    "firebase",
+    "mobile",
+    "mobile-development",
+    "claude-code",
+    "claude-code-plugin",
+    "codex",
+    "agent-skills",
+    "skills",
+    "ai-agents",
+    "code-review"
+  ]
 }

package/skills/mobile-android/SKILL.md

@@ -0,0 +1,29 @@
+---
+name: mobile-android
+description: Builds native Android apps with the Android team's guides — Jetpack Compose UI, adaptive layouts, edge-to-edge, Compose styles, migrating XML views to Compose, Navigation 3 and predictive back; Android Gradle Plugin 9 upgrades, R8 keep rule analysis, profiling with Android Studio and Perfetto, and the Android CLI; Google Play policy compliance, Play Billing upgrades and the Engage SDK; Credential Manager restore and verified email; CameraX and Media3 Cast; App Functions and the ML Kit GenAI Prompt API; Wear OS, Android TV and display glasses. Use when writing, upgrading or auditing native Android (Kotlin) code for any of these topics, even if the user does not name the library.
+intents: [performance, release, migration, build, dependency]
+stacks: [android]
+---
+
+# Mobile Android
+
+Guides for building native Android apps, most of them from the Android team (`android/skills`). Cross-platform topics live in their own skills and have Android references there: architecture in `mobile-architecture`, tests in `mobile-test`, debugging (Gradle, crashes, ANRs) in `mobile-debug`, code review in `mobile-code-review`, security in `mobile-security` and Firebase in `mobile-firebase`.
+
+## Pick the topic
+
+| Topic | Read |
+|---|---|
+| UI and navigation | [references/ui.md](references/ui.md) |
+| Build, performance and tooling | [references/build-and-performance.md](references/build-and-performance.md) |
+| Google Play | [references/play.md](references/play.md) |
+| Identity | [references/identity.md](references/identity.md) |
+| Camera and media | [references/media.md](references/media.md) |
+| On-device AI | [references/on-device-ai.md](references/on-device-ai.md) |
+| Other form factors | [references/devices.md](references/devices.md) |
+
+Each topic file lists its guides; open only the ones the task needs.
+
+## Before writing code
+
+- Check the AGP, Kotlin, Compose BOM and `compileSdk`/`targetSdk` versions in the build files and version catalog; several guides depend on minimum versions.
+- Several guides prescribe running specific tools or scripts and following steps strictly; run what writes files only with the user's agreement.

package/skills/{android-agp-9-upgrade/SKILL.md → mobile-android/references/build-and-performance/agp-9-upgrade/GUIDE.md}

@@ -1,23 +1,4 @@
----
-name: android-agp-9-upgrade
-description: Upgrades, or migrates, an Android project to use Android Gradle Plugin
-  (AGP) version 9. Do not use this skill for migrating Kotlin Multiplatform (KMP)
-  projects.
-license: Apache-2.0
-source: https://github.com/android/skills
-intents: [migration, build, dependency]
-stacks: [android]
-metadata:
-  author: Google LLC
-  last-updated: '2026-08-18'
-  keywords:
-  - Android Gradle Plugin 9
-  - AGP 9
-  - AGP Upgrade
-  - AGP Migration
-  - New AGP DSL
-  - Migrate to built-in Kotlin
----
+> Adapted from the `agp-9-upgrade` skill in [android/skills](https://github.com/android/skills) (Apache-2.0). See `THIRD_PARTY_NOTICES.md`.
 
 ## Migration guide
 

package/skills/{android-cli/SKILL.md → mobile-android/references/build-and-performance/android-cli/GUIDE.md}

@@ -1,28 +1,4 @@
----
-name: android-cli
-description: Provides instructions for installing and using the `android` CLI. The
-  `android` command-line tool is a critical tool for Android development and helps
-  you create new Android projects, run Android apps on devices, manage and interact
-  with Android virtual devices (including screenshots and UI inspection), manage Android
-  SDK components, look up official Android documentation, and discover and install
-  official Android skills.
-license: Apache-2.0
-source: https://github.com/android/skills
-routing: manual
-stacks: [android]
-metadata:
-  author: Google LLC
-  last-updated: '2026-09-12'
-  keywords:
-  - android-cli
-  - sdk
-  - emulator
-  - skills
-  - docs
-  - knowledge base
-  - project creation
-  - screenshots
----
+> Adapted from the `android-cli` skill in [android/skills](https://github.com/android/skills) (Apache-2.0). See `THIRD_PARTY_NOTICES.md`.
 
 This skill provides instructions for using the `android` CLI tool. The tool
 includes various commands for creating projects, running applications,

package/skills/{android-profiler/SKILL.md → mobile-android/references/build-and-performance/android-profiler/GUIDE.md}

@@ -1,30 +1,4 @@
----
-name: android-profiler
-description: >
-  Manages Android performance profiling and debugging. Triggers when the user
-  asks to record or analyze Android performance data, such as system traces,
-  heap dumps, method recordings, callstack samples, memory allocations, or
-  investigate bottlenecks, jank, memory leaks, and app startup issues on
-  Android, or when the user asks to write, debug, or execute ad-hoc SQL
-  queries. Applies to both user and system apps or services.
-license: Apache-2.0
-source: https://github.com/android/skills
-intents: [performance]
-stacks: [android]
-metadata:
-  author: Google LLC
-  last-updated: '2026-08-06'
-  keywords:
-    - Android performance
-    - debugging
-    - profiling
-    - recording
-    - trace analysis
-    - memory leaks
-    - bottleneck
-    - jank
-    - SQL
----
+> Adapted from the `android-profiler` skill in [android/skills](https://github.com/android/skills) (Apache-2.0). See `THIRD_PARTY_NOTICES.md`.
 
 # Android Profiler Orchestrator
 

package/skills/{android-r8-analyzer/SKILL.md → mobile-android/references/build-and-performance/r8-analyzer/GUIDE.md}

@@ -1,23 +1,4 @@
----
-name: android-r8-analyzer
-description: Analyzes Android build files and R8 keep rules to identify redundancies,
-  broad package-wide rules, and rules that subsume library consumer keep rules. Use
-  when developers want to optimize their app's size, remove redundant or overly broad
-  keep rules, or troubleshoot Proguard configurations.
-license: Apache-2.0
-source: https://github.com/android/skills
-intents: [performance, build]
-stacks: [android]
-metadata:
-  author: Google LLC
-  last-updated: '2026-08-28'
-  keywords:
-  - R8
-  - proguard
-  - keep rules
-  - app size
-  - optimization
----
+> Adapted from the `r8-analyzer` skill in [android/skills](https://github.com/android/skills) (Apache-2.0). See `THIRD_PARTY_NOTICES.md`.
 
 ## Step 1. Setup and configuration check
 

package/skills/mobile-android/references/build-and-performance.md

@@ -0,0 +1,12 @@
+# Android: Build, performance and tooling
+
+AGP 9 upgrades, R8 keep rules, profiling with Android Studio and Perfetto, and the Android CLI.
+
+| Guide | What it covers |
+|---|---|
+| [agp-9-upgrade](build-and-performance/agp-9-upgrade/GUIDE.md) | Upgrades, or migrates, an Android project to use Android Gradle Plugin (AGP) version 9. |
+| [r8-analyzer](build-and-performance/r8-analyzer/GUIDE.md) | Analyzes Android build files and R8 keep rules to identify redundancies, broad package-wide rules, and rules that subsume library consumer keep rules. |
+| [android-profiler](build-and-performance/android-profiler/GUIDE.md) | Manages Android performance profiling and debugging. |
+| [android-cli](build-and-performance/android-cli/GUIDE.md) | Provides instructions for installing and using the `android` CLI. |
+
+Each guide lives in its own folder with its references and scripts. Relative paths in a guide — and `<repo_root>` where a guide uses it — refer to that guide's folder.

package/skills/{android-display-glasses-with-jetpack-compose-glimmer/SKILL.md → mobile-android/references/devices/display-glasses-with-jetpack-compose-glimmer/GUIDE.md}

@@ -1,27 +1,4 @@
----
-name: android-display-glasses-with-jetpack-compose-glimmer
-description: Provides guidelines for developing projected Android XR apps for display
-  glasses using the Jetpack Compose Glimmer UI toolkit. This skill covers foundational
-  Glimmer design principles, workflows for implementing Jetpack Compose Glimmer, and
-  interaction models for the glasses form factor. Use this skill to build an Android
-  XR Augmented Experience app with Jetpack Compose Glimmer that adheres to the Glimmer
-  design system for optimized glasses styling.
-license: Apache-2.0
-source: https://github.com/android/skills
-routing: manual
-stacks: [android]
-metadata:
-  author: Google LLC
-  last-updated: '2026-09-08'
-  keywords:
-  - Jetpack Compose Glimmer
-  - audio glasses
-  - display glasses
-  - Projected Activity
-  - GlimmerTheme
-  - Additive Display
-  - Android XR - Augmented Experiences
----
+> Adapted from the `display-glasses-with-jetpack-compose-glimmer` skill in [android/skills](https://github.com/android/skills) (Apache-2.0). See `THIRD_PARTY_NOTICES.md`.
 
 ## Glossary
 

package/skills/{android-leanback-to-compose-tv-migration/SKILL.md → mobile-android/references/devices/leanback-to-compose-tv-migration/GUIDE.md}

@@ -1,40 +1,4 @@
----
-name: android-leanback-to-compose-tv-migration
-description: Provides instructions and architectural patterns for migrating Android
-  TV applications from legacy Leanback UI Toolkit, Android Views, or Support Fragments
-  to Jetpack Compose for TV (androidx.tv). Use this skill for Leanback to Compose
-  migrations, including browse screen, settings screen, authentication screen, login
-  screen, or video playback screen migrations, or when replacing BrowseSupportFragment,
-  LeanbackSettingsFragment, PreferenceFragment, BaseLeanbackPreferenceFragmentCompat,
-  VideoSupportFragment, GuidedStepSupportFragment, SearchSupportFragment, VerticalGridSupportFragment,
-  Presenter, ArrayObjectAdapter, or CursorMapper with modern Compose equivalents,
-  implementing immersive carousels with focus memory, Media3 video playback with PlayerSurface,
-  or custom 10-foot hero layouts.
-license: Apache-2.0
-source: https://github.com/android/skills
-routing: manual
-stacks: [android]
-metadata:
-  author: Google LLC
-  last-updated: '2026-09-03'
-  keywords:
-  - Android TV
-  - Jetpack Compose
-  - Leanback
-  - migration
-  - androidx.tv
-  - Carousel
-  - 10-foot UI
-  - PlayerSurface
-  - Media3
-  - focusRestorer
-  - FocusRequester
-  - TV development
-  - Android Views
-  - LeanbackSettingsFragment
-  - PreferenceFragment
-  - BrowseSupportFragment
----
+> Adapted from the `leanback-to-compose-tv-migration` skill in [android/skills](https://github.com/android/skills) (Apache-2.0). See `THIRD_PARTY_NOTICES.md`.
 
 ## The 10-foot UI
 

package/skills/{android-wear-compose-m3/SKILL.md → mobile-android/references/devices/wear-compose-m3/GUIDE.md}

@@ -1,28 +1,4 @@
----
-name: android-wear-compose-m3
-description: Expert guidance for working with Wear OS Compose Material3. Use this
-  skill when creating, updating, or migrating Wear OS projects. This includes the
-  androidx.wear.compose.material3, androidx.wear.compose.foundation, and androidx.wear.compose.navigation3
-  libraries. Also working with core components such as AppScaffold, ScreenScaffold,
-  and TransformingLazyColumn, and core Wear OS concepts such as ambient mode. Migration
-  from lower versions such as Material 2.5 and Horologist. This also includes creating
-  previews.
-license: Apache-2.0
-source: https://github.com/android/skills
-routing: manual
-stacks: [android]
-metadata:
-  author: Google LLC
-  last-updated: '2026-09-10'
-  keywords:
-  - Wear OS
-  - Compose
-  - Material3
-  - Horologist
-  - TransformingLazyColumn
-  - AppScaffold
-  - ScreenScaffold
----
+> Adapted from the `wear-compose-m3` skill in [android/skills](https://github.com/android/skills) (Apache-2.0). See `THIRD_PARTY_NOTICES.md`.
 
 ## Prerequisites and compatibility
 

package/skills/mobile-android/references/devices.md

@@ -0,0 +1,11 @@
+# Android: Other form factors
+
+Wear OS, Android TV and display glasses.
+
+| Guide | What it covers |
+|---|---|
+| [wear-compose-m3](devices/wear-compose-m3/GUIDE.md) | Expert guidance for working with Wear OS Compose Material3. |
+| [leanback-to-compose-tv-migration](devices/leanback-to-compose-tv-migration/GUIDE.md) | Provides instructions and architectural patterns for migrating Android TV applications from legacy Leanback UI Toolkit, Android Views, or Support Fragments to Jetpack Compose for TV (androidx.tv). |
+| [display-glasses-with-jetpack-compose-glimmer](devices/display-glasses-with-jetpack-compose-glimmer/GUIDE.md) | Provides guidelines for developing projected Android XR apps for display glasses using the Jetpack Compose Glimmer UI toolkit. |
+
+Each guide lives in its own folder with its references and scripts. Relative paths in a guide — and `<repo_root>` where a guide uses it — refer to that guide's folder.

package/skills/{android-restore-credentials/SKILL.md → mobile-android/references/identity/restore-credentials/GUIDE.md}

@@ -1,26 +1,4 @@
----
-name: android-restore-credentials
-description: Provides knowledge and workflows to implement Android's Restore Credentials
-  feature using the androidx.credentials library. Use this skill to create, sign in
-  with, and delete restore keys, enabling silent user sign-in on new devices after
-  a restore. It covers version compatibility, dependencies, server-side prerequisites,
-  and the complete client-side implementation for creating, retrieving, and clearing
-  restore keys.
-license: Apache-2.0
-source: https://github.com/android/skills
-routing: manual
-stacks: [android]
-metadata:
-  author: Google LLC
-  last-updated: '2026-09-14'
-  keywords:
-  - Credential Manager
-  - Restore Credentials
-  - backup & restore
-  - backup
-  - restore
-  - implementation
----
+> Adapted from the `restore-credentials` skill in [android/skills](https://github.com/android/skills) (Apache-2.0). See `THIRD_PARTY_NOTICES.md`.
 
 ## Fundamentals
 

package/skills/{android-verified-email/SKILL.md → mobile-android/references/identity/verified-email/GUIDE.md}

@@ -1,31 +1,4 @@
----
-name: android-verified-email
-description: Provides a complete workflow for implementing verified email retrieval
-  on Android Credential Manager API. Use this skill to integrate a secure, OTP-less
-  email verification flow into an Android app. This skill solves the problem of high-friction
-  sign-up processes by leveraging cryptographically verified credentials from trusted
-  providers like Google.
-license: Apache-2.0
-source: https://github.com/android/skills
-routing: manual
-stacks: [android]
-metadata:
-  author: Google LLC
-  last-updated: '2026-09-04'
-  keywords:
-  - implementation
-  - Android
-  - Credential Manager
-  - Digital Credentials
-  - Verified Email
-  - OpenID4VP
-  - SD-JWT
-  - OTP-less
-  - authentication
-  - passkeys
-  - CredMan
-  - identity.
----
+> Adapted from the `verified-email` skill in [android/skills](https://github.com/android/skills) (Apache-2.0). See `THIRD_PARTY_NOTICES.md`.
 
 ## Fundamentals
 

package/skills/mobile-android/references/identity.md

@@ -0,0 +1,10 @@
+# Android: Identity
+
+Credential restore and verified email with Credential Manager.
+
+| Guide | What it covers |
+|---|---|
+| [restore-credentials](identity/restore-credentials/GUIDE.md) | Provides knowledge and workflows to implement Android's Restore Credentials feature using the androidx.credentials library. |
+| [verified-email](identity/verified-email/GUIDE.md) | Provides a complete workflow for implementing verified email retrieval on Android Credential Manager API. |
+
+Each guide lives in its own folder with its references and scripts. Relative paths in a guide — and `<repo_root>` where a guide uses it — refer to that guide's folder.

package/skills/{android-camerax/SKILL.md → mobile-android/references/media/camerax/GUIDE.md}

@@ -1,33 +1,4 @@
----
-name: android-camerax
-description: Provide technical guidance for Android camera development with CameraX.
-  Use when implementing camera features, handling asynchronous recording lifecycles,
-  wiring low-level hardware interop using CameraX, or integrating ML Kit or Media3
-  effects.
-license: Apache-2.0
-source: https://github.com/android/skills
-routing: manual
-stacks: [android]
-metadata:
-  author: Google LLC
-  last-updated: '2026-08-14'
-  keywords:
-  - recipe
-  - Android
-  - Camera
-  - Camera1
-  - Camera2
-  - CameraX
-  - migration
-  - Compose
-  - guide
-  - dependencies
-  - PreviewView
-  - CameraXViewfinder
-  - ImageCapture
-  - VideoCapture
-  - ImageAnalysis.
----
+> Adapted from the `camerax` skill in [android/skills](https://github.com/android/skills) (Apache-2.0). See `THIRD_PARTY_NOTICES.md`.
 
 This skill provides procedural guidance and standard patterns for building
 camera applications on Android, with a focus on CameraX, including its

package/skills/{android-media3-cast-integration/SKILL.md → mobile-android/references/media/media3-cast-integration/GUIDE.md}

@@ -1,27 +1,4 @@
----
-name: android-media3-cast-integration
-description: Implements Google Cast support in Android apps using Jetpack Media3.
-  Handles adding build dependencies, updating manifest, configuring OptionsProvider,
-  and managing CastPlayer or RemoteCastPlayer for playback in both Compose and View-based
-  UIs. Use when adding Cast functionality or migrating from legacy Cast SDK to Media3
-  Cast.
-license: Apache-2.0
-source: https://github.com/android/skills
-routing: manual
-stacks: [android]
-metadata:
-  author: Google LLC
-  last-updated: '2026-08-14'
-  keywords:
-  - Android
-  - Media3
-  - Cast
-  - Integration
-  - Migration
-  - ExoPlayer
-  - MediaSession
-  - Jetpack Media3
----
+> Adapted from the `media3-cast-integration` skill in [android/skills](https://github.com/android/skills) (Apache-2.0). See `THIRD_PARTY_NOTICES.md`.
 
 ## Prerequisites
 

package/skills/mobile-android/references/media.md

@@ -0,0 +1,10 @@
+# Android: Camera and media
+
+CameraX and Media3 Cast.
+
+| Guide | What it covers |
+|---|---|
+| [camerax](media/camerax/GUIDE.md) | Provide technical guidance for Android camera development with CameraX. |
+| [media3-cast-integration](media/media3-cast-integration/GUIDE.md) | Implements Google Cast support in Android apps using Jetpack Media3. |
+
+Each guide lives in its own folder with its references and scripts. Relative paths in a guide — and `<repo_root>` where a guide uses it — refer to that guide's folder.

package/skills/{android-appfunctions/SKILL.md → mobile-android/references/on-device-ai/appfunctions/GUIDE.md}

@@ -1,27 +1,4 @@
----
-name: android-appfunctions
-description: Analyzes Android apps to identify key user workflows for AppFunctions
-  such as creating a note, playing media, or sending an automated or AI agent triggered
-  message, voice commands, or system shortcuts, without needing to open the app UI.
-  Generates Kotlin code to expose these workflows to the Android system, allowing
-  agents to discover and execute them on-device. Also refines KDoc documentation to
-  ensure AI agents correctly understand and use the provided functionality.
-license: Apache-2.0
-source: https://github.com/android/skills
-routing: manual
-stacks: [android]
-metadata:
-  author: Google LLC
-  last-updated: '2026-08-14'
-  keywords:
-  - AppFunctions
-  - Kotlin
-  - KSP
-  - ADB
-  - AI
-  - LLM
-  - MCP
----
+> Adapted from the `appfunctions` skill in [android/skills](https://github.com/android/skills) (Apache-2.0). See `THIRD_PARTY_NOTICES.md`.
 
 Analyzes Android apps to identify key user workflows for AppFunctions such as
 creating a note, playing media, or sending an automated or AI agent triggered

package/skills/{android-ml-kit-genai-prompt-api/SKILL.md → mobile-android/references/on-device-ai/ml-kit-genai-prompt-api/GUIDE.md}

@@ -1,23 +1,4 @@
----
-name: android-ml-kit-genai-prompt-api
-description: Analyzes Android codebases to implement ML Kit GenAI Prompt API. Use
-  this skill to send natural language requests on-device to Gemini Nano, use structured
-  output with Prompt API, implement prefix caching, optimize the current prompt, or
-  apply best practices."
-license: Apache-2.0
-source: https://github.com/android/skills
-routing: manual
-stacks: [android]
-metadata:
-  author: Google LLC
-  last-updated: '2026-09-03'
-  keywords:
-  - ML Kit
-  - Prompt API
-  - Structured Output
-  - Prefix Caching
-  - Gemini Nano
----
+> Adapted from the `ml-kit-genai-prompt-api` skill in [android/skills](https://github.com/android/skills) (Apache-2.0). See `THIRD_PARTY_NOTICES.md`.
 
 This skill provides step-by-step guidance for integrating and optimizing the ML
 Kit GenAI Prompt API in Android apps.

package/skills/mobile-android/references/on-device-ai.md

@@ -0,0 +1,10 @@
+# Android: On-device AI
+
+App Functions and the ML Kit GenAI Prompt API.
+
+| Guide | What it covers |
+|---|---|
+| [appfunctions](on-device-ai/appfunctions/GUIDE.md) | Analyzes Android apps to identify key user workflows for AppFunctions such as creating a note, playing media, or sending an automated or AI agent triggered message, voice commands, or system shortcuts, without needing to open the app UI. |
+| [ml-kit-genai-prompt-api](on-device-ai/ml-kit-genai-prompt-api/GUIDE.md) | Analyzes Android codebases to implement ML Kit GenAI Prompt API. |
+
+Each guide lives in its own folder with its references and scripts. Relative paths in a guide — and `<repo_root>` where a guide uses it — refer to that guide's folder.

package/skills/{android-engage-sdk-integration/SKILL.md → mobile-android/references/play/engage-sdk-integration/GUIDE.md}

@@ -1,22 +1,4 @@
----
-name: android-engage-sdk-integration
-description: Helps developers integrate, debug, and resolve Play Engage SDK implementation
-  issues. Use when adding Engage SDK support, generating publishing code, mapping
-  data classes to entities, or fixing SDK-related errors.
-license: Apache-2.0
-source: https://github.com/android/skills
-routing: manual
-stacks: [android]
-metadata:
-  author: Google LLC
-  last-updated: '2026-09-01'
-  keywords:
-  - android
-  - engage
-  - engage sdk
-  - play engage library
-  - google play
----
+> Adapted from the `engage-sdk-integration` skill in [android/skills](https://github.com/android/skills) (Apache-2.0). See `THIRD_PARTY_NOTICES.md`.
 
 This skill guides you through integrating the Play Engage SDK into an Android
 app. It ensures that the code follows the mandatory structure and uses the

package/skills/{android-play-billing-library-version-upgrade/SKILL.md → mobile-android/references/play/play-billing-library-version-upgrade/GUIDE.md}

@@ -1,25 +1,4 @@
----
-name: android-play-billing-library-version-upgrade
-description: Use this skill when upgrading or migrating an Android project from any
-  legacy Google Play Billing Library (PBL) version to the latest stable version of
-  PBL.
-license: Apache-2.0
-source: https://github.com/android/skills
-routing: manual
-stacks: [android]
-metadata:
-  author: Google LLC
-  last-updated: '2026-09-01'
-  keywords:
-  - android
-  - play billing
-  - play billing library
-  - pbl
-  - upgrade
-  - migration
-  - deprecation
-  - google play
----
+> Adapted from the `play-billing-library-version-upgrade` skill in [android/skills](https://github.com/android/skills) (Apache-2.0). See `THIRD_PARTY_NOTICES.md`.
 
 ## Phase 0: Intent Message
 

package/skills/{android-play-policy-insights/SKILL.md → mobile-android/references/play/play-policy-insights/GUIDE.md}

@@ -1,46 +1,4 @@
----
-name: android-play-policy-insights
-description: Automated auditor designed to verify Android applications against Google Play Policy domains. It cross-references static code analysis with Play Store declarations to generate deterministic compliance reports, identifying undeclared data collection, architectural risks, and missing disclosures across Permissions and APIs Hygiene, User Account and Identity, and Data Safety and Privacy domains.
-license: Apache-2.0
-source: https://github.com/android/skills
-intents: [release]
-stacks: [android]
-metadata:
-  author: Google LLC
-  last-updated: '2026-07-13'
-  keywords:
-  - account deletion
-  - accessibility api
-  - all files access
-  - audio recording
-  - audit
-  - compliance
-  - contacts access
-  - data disclosure
-  - data safety
-  - data safety label
-  - data transmission
-  - demo credentials
-  - exact alarm
-  - foreground services
-  - location access
-  - login credentials
-  - manifest hygiene
-  - package visibility
-  - permissions hygiene
-  - photo and video access
-  - photopicker
-  - play policy
-  - pre-submission audit
-  - privacy policy
-  - prominent disclosure
-  - restricted permissions
-  - scoped storage
-  - sms and call log
-  - static analysis
-  - target sdk
-  - user consent
----
+> Adapted from the `play-policy-insights` skill in [android/skills](https://github.com/android/skills) (Apache-2.0). See `THIRD_PARTY_NOTICES.md`.
 
 # Play Policy Insights: data safety, login credentials, and restricted permissions
 

package/skills/mobile-android/references/play.md

@@ -0,0 +1,11 @@
+# Android: Google Play
+
+Play policy compliance, Play Billing upgrades and the Engage SDK.
+
+| Guide | What it covers |
+|---|---|
+| [play-policy-insights](play/play-policy-insights/GUIDE.md) | Automated auditor designed to verify Android applications against Google Play Policy domains. |
+| [play-billing-library-version-upgrade](play/play-billing-library-version-upgrade/GUIDE.md) | Use this skill when upgrading or migrating an Android project from any legacy Google Play Billing Library (PBL) version to the latest stable version of PBL. |
+| [engage-sdk-integration](play/engage-sdk-integration/GUIDE.md) | Helps developers integrate, debug, and resolve Play Engage SDK implementation issues. |
+
+Each guide lives in its own folder with its references and scripts. Relative paths in a guide — and `<repo_root>` where a guide uses it — refer to that guide's folder.