Generated banner for Play Policy Insights
Generated logo for Play Policy Insights

Play Policy Insights

Android (Google)OfficialCreated by Google LLCDistributed by Android (Google)

  • Skill
  • Review and audit
  • Security
  • Apache-2.0
  • Low risk
  • Has scripts

From the author

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.
— the description by Google LLC

AutoGineer summary

Written by AutoGineer from the skill’s own files, not by the author

Play Policy Insights is an automated auditing tool designed to evaluate Android applications for compliance with Google Play Policy domains. It performs static code analysis and cross-references findings with Play Store declarations to identify potential issues such as undeclared data collection, architectural risks, and missing disclosures. The skill operates through a structured two-phase protocol, managing fact gathering, triage, and goal-oriented analysis to generate comprehensive compliance reports.

What it does

  • Performs static analysis on Android application codebases.
  • Cross-references code findings with Play Store policy declarations.
  • Identifies undeclared data collection and missing privacy disclosures.
  • Audits permissions, API hygiene, and user account/identity implementations.
  • Generates deterministic compliance reports for pre-submission review.
  • Supports both delegated and sequential execution modes for audit tasks.

When to use it

  • Before submitting an Android application to the Google Play Store.
  • When verifying compliance with Data Safety and Privacy policies.
  • To audit an app's use of restricted permissions and sensitive APIs.
  • To ensure demo login credentials and account deletion flows meet policy standards.

Advantages

  • Provides a structured, repeatable audit process for policy compliance.
  • Reduces manual effort by automating static analysis and report generation.
  • Ensures consistent evaluation across different audit domains.
  • Includes built-in safeguards for file system management and task execution.

Usage examples

“Run a compliance audit on the Android app located in /path/to/app_code.”
The agent initializes the audit environment, performs static analysis, executes goal-oriented checks, and generates a final compliance_report.md.

Install

  1. Download the skill as a ZIP:

    https://autogineer.com/agent-skills/android/play-policy-insights/download
  2. Unzip it into the cross-client skills folder of your project:

    mkdir -p .agents/skills && unzip play-policy-insights.zip -d .agents/skills

Documentation by Google LLC

Play Policy Insights: data safety, login credentials, and restricted permissions

You must audit Android apps for three specific policy domains. You must check data safety, demo login credentials, and restricted permissions.

Path Resolution

  • repo_root: Absolute path to the directory containing this SKILL.md.

  • app_dir:: Absolute path to the directory containing app's code.

  • temp_dir: Absolute path to the scratch directory at the workspace root. It is located at .scratch/play_policy_insights_<uuid>. Containment Mandate: You must confine all file system writes, intermediate artifacts, and logs strictly to this directory. This ensures the skill remains portable and safe across diverse execution environments, including local harnesses and CI/CD pipelines, by avoiding reliance on system-level temporary paths or user home directories.

Critical mandates

  • Execution Mode Awareness Before starting Phase 2, evaluate if your execution environment provides a tool to spawn or delegate tasks to general-purpose sub-agents (e.g., tools often named invoke_agent, delegate_task, or spawn_worker, using generic agent profiles like 'generalist' or 'coding_agent').

  • If YES, you MUST use Mode A (Delegation).

  • If NO, use Mode B (Sequential Self-Execution). You must read the prompt files intended for the subagents, follow their instructions, and write the expected output files to disk.

  • Sub-agents orchestration:

    • If you use "Mode A (Delegation)", wait for "SUCCESS" confirmation from sub-agents to know when they are done.

    • Idempotency & Timeout Safeguard: If a sub-agent fails or times out, you MUST verify the presence and integrity of its target output file (e.g., <temp_dir>/worker_<goal_name>.json) before retrying. If the file exists and contains valid JSON, treat the execution as SUCCESS and proceed. Otherwise, retry up to three times.

  • Fail-fast mandate: The automated audit in Phase 1 is the source of truth. If orchestrator.py fails, you must stop immediately with an explanation of failure. Do not use manual auditing as a fallback.

The two-phase protocol

Phase 1: Fact gathering and triage
  1. Initialize and triage:

    • Run python3 <repo_root>/scripts/orchestrator.py init <app_dir>.

    • This will create the scratch environment, perform static analysis, map the codebase, identify audit goals, and produce prompts for subagents for each audit goal and prompts for designated critic and aggregator subagents.

    • You must wait (up to 5 minutes) for the script to finish.

  2. Capture environment: Note values of the temp_dir, and activated_goals from the JSON output. You will need them in Phase 2.

  3. Evaluate goals: If activated_goals is empty, skip to step 3 of Phase 2 (Aggregation). Otherwise, proceed to step 1 of Phase 2 (Detailed analysis).

Phase 2: Goal-oriented audit

Determine your execution capabilities and proceed with either Mode A OR Mode B.

Mode A: Orchestrator WITH Delegation Capabilities (Parallel)
  1. Detailed analysis: For each goal in activated_goals (e.g., permissions_and_apis, data_safety_part_1, data_safety_part_2), delegate to a sub-agent. Concurrency Limit: You must not spawn more than 3 sub-agents simultaneously. Spawn the first batch of up to 3, wait for their completions, and then spawn the next batch. Repeat until all goals are complete. Pass the prompt: "Read your instructions from <temp_dir>/prompt_worker_<goal_name>.md and execute. MANDATORY: You must use your file-writing capabilities to save your final JSON findings directly to the file system at <temp_dir>/worker_<goal_name>.json. You are strictly forbidden from outputting the JSON in your chat response. To minimize context usage, your final response must be exactly 'SUCCESS' and nothing else." Validate: Confirm every <temp_dir>/worker_<goal_name>.json exists and contains valid JSON. If a sub-agent fails or times out, but the valid JSON output file is already present on disk, do NOT retry; proceed normally. Only retry the corresponding worker (up to three times) if the file is missing or invalid.

  2. Aggregate Findings: Execute the python aggregation command: python3 <repo_root>/scripts/orchestrator.py aggregate <temp_dir>. This produces aggregated_findings.json and returns a JSON object containing critic_chunks representing the number of chunks to verify (e.g., {"temp_dir": "...", "critic_chunks": 2}).

  3. Parallel Critic review: For each chunk index i from 1 to critic_chunks, delegate to a sub-agent. Concurrency Limit: You must not spawn more than 3 critic sub-agents simultaneously. Batch them in groups of 3 as above. Pass the prompt: "Read your instructions from <temp_dir>/prompt_critic_<i>.md and execute. MANDATORY: You must use your file-writing capabilities to save your final JSON findings directly to the file system at <temp_dir>/critic_output_<i>.json. You are strictly forbidden from outputting the JSON in your chat response. To minimize context usage, your final response must be exactly 'SUCCESS' and nothing else." Validate: Confirm each <temp_dir>/critic_output_<i>.json exists and contains valid JSON before proceeding. If it failed or timed out, but the valid JSON file is present, proceed normally. Otherwise, retry that specific critic chunk.

  4. Proceed to Finalization (Step 4 below)

Mode B: Orchestrator WITHOUT Delegation Capabilities (Sequential)
  1. Detailed Analysis: For each goal in activated_goals, sequentially:

    • Read the contents of <temp_dir>/prompt_worker_<goal_name>.md.

    • Execute the instructions contained within that file yourself.

    • CRITICAL: You MUST format your findings exactly as requested in the prompt and save them to <temp_dir>/worker_<goal_name>.json. Do not summarize findings in your thoughts or chat; move to the next task.

    • Validate: Confirm <temp_dir>/worker_<goal_name>.json exists before moving to the next goal.

  2. Aggregate Findings: Execute the python aggregation command: python3 <repo_root>/scripts/orchestrator.py --aggregate <temp_dir>. This produces aggregated_findings.json and returns a JSON object containing critic_chunks representing the number of chunks to verify.

  3. Sequential Critic review: For each chunk index i from 1 to critic_chunks, sequentially:

    • Read the contents of <temp_dir>/prompt_critic_<i>.md.

    • Execute the steps yourself and save your findings to <temp_dir>/critic_output_<i>.json.

    • Validate: Confirm <temp_dir>/critic_output_<i>.json exists before moving to the next chunk.

  4. Proceed to Finalization (Step 4 below)

Finalization (Both Modes)
  1. Present findings: Run python3 <repo_root>/scripts/generate_report.py <temp_dir>. It will produce <temp_dir>/compliance_report.md. Present this output file to user.

  2. STOP: The audit is complete. Await further instructions.

Files

resources/goal_permissions_and_apis.md

{{#IF_ALL requested_permissions.exact_alarm, exact_alarm}}{{ACTIVATE_GOAL}}{{/IF_ALL}} {{#IF_ALL requested_permissions.foreground_service, foreground_service}}{{ACTIVATE_GOAL}}{{/IF_ALL}} {{#IF_ALL requested_permissions.accessibility, accessibility}}{{ACTIVATE_GOAL}}{{/IF_ALL}} {{#IF_ALL requested_permissions.APPS_ON_DEVICE, data_sources.APPS_ON_DEVICE}}{{ACTIVATE_GOAL}}{{/IF_ALL}} {{#IF_ALL requested_permissions.SMS_CALL_LOG, data_sources.SMS_CALL_LOG}}{{ACTIVATE_GOAL}}{{/IF_ALL}} {{#IF_ALL requested_permissions.MEDIA, data_sources.MEDIA}}{{ACTIVATE_GOAL}}{{/IF_ALL}} {{#IF_ALL requested_permissions.AUDIO, data_sources.AUDIO}}{{ACTIVATE_GOAL}}{{/IF_ALL}} {{#IF_ALL requested_permissions.ALL_FILES, data_sources.FILES_AND_DOCS}}{{ACTIVATE_GOAL}}{{/IF_ALL}} {{#IF_ALL requested_permissions.LOCATION, data_sources.PRECISE_LOCATION}}{{ACTIVATE_GOAL}}{{/IF_ALL}} {{#IF_ALL requested_permissions.LOCATION, data_sources.APPROX_LOCATION}}{{ACTIVATE_GOAL}}{{/IF_ALL}} {{#IF_ALL requested_permissions.CONTACTS, data_sources.CONTACTS}}{{ACTIVATE_GOAL}}{{/IF_ALL}}

Permissions and APIs Audit

Hint: Deducing Core Functionality

Since you must determine if certain permissions are justified by the app's "core purpose", use these fast heuristics:

  1. The "Broken" Test: Is the feature essential to the app's primary purpose? If the app would still be functional and useful without the feature, it is NOT core functionality.

  2. Manifest Intent: Review AndroidManifest.xml. The name of the LAUNCHER Activity and specialized <intent-filter> declarations (like default SMS handlers) strongly indicate the app's main purpose.

  3. Naming: The package name ({{PACKAGE_NAME}}) and app label ({{APP_NAME}}) often describe the app's purpose explicitly.

  4. Execution Context: Usage in classes like BackupManager suggest core functionality, whereas usage in AdHelper, CrashReporter, or AnalyticsManager indicates secondary features.

  5. Mandatory Rule: Secondary features like advertising, analytics, or social sharing never justify restricted permissions like Background Location, All Files Access, or Broad Media Access.


Policies to Verify

{{#IF_ALL requested_permissions.MEDIA, data_sources.MEDIA}}

Photo and Video Access Policy (Policy ID: photo_video_access_policy)
  • Goal: Evaluate if the app's core functionality justifies broad access to photos or if it should migrate to the Android Photo Picker.

  • The Policy Spirit: User privacy is paramount. Apps should only request broad media storage permissions if they are dedicated media managers (like Gallery or Backup apps). For standard tasks like profile picture uploads, custom sharing, or attaching media, developers must use scoped APIs to prevent security risks.

  • Evidence: {{#EACH data_sources.MEDIA}}

    • {{ITEM}} {{/EACH}} Relevant Permissions Requested: {{#EACH requested_permissions.MEDIA}}

    • {{ITEM}} {{/EACH}} {{#IF TARGET_SDK}} Target SDK: {{TARGET_SDK}} {{/IF}}

  • Common Evaluation Matrix:

    Target SDKBroad Media Permission Requested?Condition / Context CheckedSeverityDirect Actionable Recommendation
    33 or higherYesApp requests broad media access (e.g. READ_MEDIA_IMAGES), but features only require user-selected media.IMPORTANTMigrate to the Android Photo Picker (MediaStore.ACTION_PICK_IMAGES) which does not require any permission prompt.
    AnyYesApp requests broad storage/media permissions but is not a dedicated media manager (e.g., a social or utility app).IMPORTANTMigrate to the Android Photo Picker for single-item or multi-item media selection.
  • Domain-Specific Heuristics (Strictly Bounded): Look beyond standard native file pickers. Extrapolate using this heuristic:

    1. User-Selected Media Heuristic: Analyze where the code handles selected files. If images or videos are loaded strictly via a user-facing button click (e.g., "Upload Avatar", "Share Photo", "Attach File") and processed one-at-a-time, broad filesystem media permissions are structurally unnecessary. Flag an IMPORTANT violation and recommend Photo Picker migration. {{/IF_ALL}}

{{#IF_ALL requested_permissions.ALL_FILES, data_sources.FILES_AND_DOCS}}

All Files Access Policy (Policy ID: all_files_access_policy)
  • Goal: Evaluate if the app's core purpose justifies the high-risk MANAGE_EXTERNAL_STORAGE permission.

  • The Policy Spirit: Full filesystem access is a restricted privilege. The Play Store strictly limits MANAGE_EXTERNAL_STORAGE to apps where full disk reads/writes are critical to the core purpose (e.g., file managers, antivirus scanner, backup tools). Non-compliant apps must utilize Scoped Storage or Storage Access Framework (SAF).

  • Evidence: {{#EACH data_sources.FILES_AND_DOCS}}

    • {{ITEM}} {{/EACH}} Relevant Permissions Requested: {{#EACH requested_permissions.ALL_FILES}}

    • {{ITEM}} {{/EACH}}

  • Common Evaluation Matrix:

    Core App PurposeIs Permission Justified?SeverityDirect Actionable Recommendation
    File Manager, Antivirus, Backup/Restore, or Document ManagerYes (Compliant)NoneNo action needed; core purpose justifies the restricted permission.
    Standard Utility, Social Media, Game, or Productivity AppNo (Violation)CRITICALRemove MANAGE_EXTERNAL_STORAGE from the Manifest. For document picking or local file saving, migrate to the Storage Access Framework (SAF).
  • Domain-Specific Heuristics (Strictly Bounded): Surgically audit how the filesystem is queried:

    1. Scoped Storage Sufficiency: Check the files using the storage APIs. If the app is using filesystem pathways solely to log diagnostics, store custom caches, or save simple download artifacts, broad access is not justified. Recommend using app-specific directories (Context.getExternalFilesDir()) which require zero permissions. {{/IF_ALL}}

{{#IF requested_permissions.LOCATION}} {{#IF_ANY data_sources.PRECISE_LOCATION, data_sources.APPROX_LOCATION}}

Location Access Policy (Policy ID: location_access_policy)
  • Goal: Verify that location access is essential, uses minimum scope, and is properly disclosed.

  • The Policy Spirit: User tracking is extremely sensitive. Apps must collect the minimum scope of location required (approximate vs precise), provide clear prominent disclosures, and must never utilize background tracking unless it is essential for safety, navigation, or physical fitness features.

  • Evidence: {{#IF data_sources.PRECISE_LOCATION}}

    • Precise Location usage: {{#EACH data_sources.PRECISE_LOCATION}}

      • {{ITEM}} {{/EACH}} {{/IF}} {{#IF data_sources.APPROX_LOCATION}}

    • Approximate Location usage: {{#EACH data_sources.APPROX_LOCATION}}

      • {{ITEM}} {{/EACH}} {{/IF}} Relevant Permissions Requested: {{#EACH requested_permissions.LOCATION}}

    • {{ITEM}} {{/EACH}} {{#IF TARGET_SDK}} Target SDK: {{TARGET_SDK}} {{/IF}}

  • Common Evaluation Matrix:

    ScopeTarget SDKFinding / Condition CheckedSeverityDirect Actionable Recommendation
    ForegroundAnyRequests ACCESS_FINE_LOCATION but features only require city-level or approximate weather/search features.IMPORTANTDowngrade Manifest to ACCESS_COARSE_LOCATION to respect the minimum scope mandate.
    ForegroundAnyApp purpose ({{APP_NAME}}) does not imply location, yet foreground tracking is used, and prominent disclosure alert code is missing.IMPORTANTImplement a Prominent In-App Disclosure dialog explaining what location data is collected before requesting foreground permission.
    BackgroundAnyRequests ACCESS_BACKGROUND_LOCATION solely for advertising, marketing, or general analytics.CRITICALHigh-Risk Violation: Completely remove background location collection from the codebase.
    BackgroundAnyRequests background location, but features could operate with foreground location access.IMPORTANTDowngrade the feature to foreground-only location tracking and remove background permission.
    BackgroundAnyBackground location is legitimate, but prominent disclosure does not mention "location" and "when the app is closed or not in use."IMPORTANTUpdate the Prominent Disclosure text to explicitly state "location" and "when closed or not in use".
    Foreground37 or higherPrecise location is requested on Android 17+.SUGGESTIONMigrate to the Location Button API as the minimum scope mechanism for precise foreground location.
  • Domain-Specific Heuristics (Strictly Bounded): Actively trace custom background workers and disclosures:

    1. The Foreground Sufficiency Test: Analyze background threads, WorkManager tasks, or background services triggering location updates. If the background process performs syncing or location calculations that could be deferred to when the user is actively viewing the app, flag an IMPORTANT violation.

    2. The Reasonable Expectation Test: If the app label ({{APP_NAME}}) or packages suggest a utility that shouldn't logically track location, evaluate any indirect geo-tracking (such as geo-lookup of network IP addresses, or sending local Wi-Fi SSID logs off-device). If found, flag an IMPORTANT missing prominent disclosure. {{/IF_ANY}} {{/IF}}

{{#IF_ALL requested_permissions.CONTACTS, data_sources.CONTACTS}}

Contacts Access Policy (Policy ID: contacts_access_policy)
  • Goal: Evaluate if broad contacts access (READ_CONTACTS) is justified or if the Android Contact Picker should be used.

  • The Policy Spirit: Address books contain sensitive personal details. The Play Store mandates that apps use scoped contact access unless broad, continuous contacts synchronization is critical (such as in social network friend-matching or full contact managers).

  • Evidence: {{#EACH data_sources.CONTACTS}}

    • {{ITEM}} {{/EACH}} Relevant Permissions Requested: {{#EACH requested_permissions.CONTACTS}}

    • {{ITEM}} {{/EACH}} {{#IF TARGET_SDK}} Target SDK: {{TARGET_SDK}} {{/IF}}

  • Common Evaluation Matrix:

    Target SDKAccess ModelCondition / Finding CheckedSeverityDirect Actionable Recommendation
    AnyBroad (READ_CONTACTS)Broad access is requested for one-time transactions, file sharing, referrals, or simple forms.IMPORTANTMigrate to the Android Contact Picker (Intent.ACTION_PICK_CONTACTS) to query contacts securely.
    37 or higherBroad (READ_CONTACTS)Target SDK is 37+ (effective Oct 2026), and broad access is used for secondary or standard tasks.IMPORTANTMigrate to the Android Contact Picker as broad contacts access is restricted.
  • Domain-Specific Heuristics (Strictly Bounded): Evaluate the depth of contact queries:

    1. Single-Item Verification: Search for database cursors reading contact tables (ContactsContract.CommonDataKinds). If the cursors are used solely to let a user select a single friend, mobile phone number, or email address, broad contacts access is a violation. Recommend Contact Picker. {{/IF_ALL}}

{{#IF_ALL requested_permissions.exact_alarm, exact_alarm}}

Exact Alarm Policy (Policy ID: exact_alarm_policy)
  • Goal: Evaluate if the app's core functionality justifies the USE_EXACT_ALARM permission.

  • The Policy Spirit: Exact alarms degrade system performance and battery life. The Play Store strictly limits the high-risk USE_EXACT_ALARM permission to alarm clocks, timers, and calendar apps where precise, down-to-the-second timing is critical.

  • Evidence: {{#EACH exact_alarm}}

    • {{ITEM}} {{/EACH}} Relevant Permissions Requested: {{#EACH requested_permissions.exact_alarm}}

    • {{ITEM}} {{/EACH}}

  • Common Evaluation Matrix:

    Core App PurposePermission RequestedJustified?SeverityDirect Actionable Recommendation
    Alarm Clock, Timer, or Calendar AppUSE_EXACT_ALARMYes (Compliant)NoneNo action needed.
    Standard Utility, Game, Sync, or Productivity AppUSE_EXACT_ALARMNo (Violation)IMPORTANTSwitch to SCHEDULE_EXACT_ALARM which respects system battery constraints, or use standard AlarmManager inexact scheduling.
  • Domain-Specific Heuristics (Strictly Bounded): Examine alarm trigger targets:

    1. Time-Insensitive Syncing: Verify the files scheduling alarms. If alarms are used to fetch network updates, clean cache files, trigger analytics uploads, or post local daily notifications, exact timing is not justified. Recommend using WorkManager for background tasks instead of AlarmManager. {{/IF_ALL}}

{{#IF_ALL requested_permissions.foreground_service, foreground_service}}

Foreground Services (Policy ID: foreground_services_policy)
  • Goal: Verify the declaration and justification of foreground services.

  • The Policy Spirit: Foreground services keep processes alive in the background and must be highly visible to users. Every declared service must have an appropriate foregroundServiceType defined in the Manifest, and special types like specialUse require specific tag property justifications.

  • Evidence: {{#EACH foreground_service}}

    • {{ITEM}} {{/EACH}} Relevant Permissions Requested: {{#EACH requested_permissions.foreground_service}}

    • {{ITEM}} {{/EACH}} {{#IF TARGET_SDK}} Target SDK: {{TARGET_SDK}} {{/IF}}

  • Common Evaluation Matrix:

    Service ConfigurationJustification CheckSeverityDirect Actionable Recommendation
    Missing type tagForeground service is declared but lacks a foregroundServiceType attribute.CRITICALAdd the appropriate android:foregroundServiceType attribute to the service declaration in the Manifest.
    Lacks specialUse propertyService type is specialUse, but Manifest lacks the required <property android:name="android.app.PROPERTY_SPECIAL_USE_FGS_SUBTYPE" ...> tag.CRITICALAdd the <property> tag inside the service block with a valid subtype string.
    Type MisalignmentDeclared FGS type does not logically align with the app's core purpose.IMPORTANTRe-align FGS type to match app features, or migrate background operations to WorkManager if user-visible foreground presence is not justified.
    Declaration ReminderForeground service is declared (even if type is correct).SUGGESTIONPlay Console Declaration Required: For apps targeting Android 14+, you must complete a Foreground Service declaration in the Play Console (App content section) for each type used, providing a functional description, user impact video, and a specific use case selection.
  • Domain-Specific Heuristics (Strictly Bounded): Critique specialUse justifications and service behavior:

    1. Justification String Audit: Read the text of the <property> tag for specialUse. If the text contains weak, boilerplate, or placeholder justifications (e.g., "requires background process for app to run"), flag an IMPORTANT violation warning the developer that Google Play reviewers will reject this service.

    2. Notification Integrity: Verify if the FGS implementation creates a valid user-facing notification. If no startForeground() or notification builder logic is associated with the service initiation, flag an IMPORTANT violation.

    3. Play Console Declaration Confirmation: If any foreground service is used, flag a SUGGESTION to remind the developer that a specialized declaration form in the Play Console is mandatory, requiring a video demonstration of the feature. {{/IF_ALL}}

{{#IF_ALL requested_permissions.accessibility, accessibility}}

Accessibility API Policy (Policy ID: accessibility_api_policy)
  • Goal: Verify the configuration and justification of Accessibility Services.

  • The Policy Spirit: Accessibility APIs provide deep system access to assist users with disabilities. Using these APIs for non-accessibility tasks (like UI automation, screen scraping, background monitoring, or ad blocking) is strictly prohibited by Google Play and causes immediate app rejection.

  • Evidence: {{#EACH accessibility}}

    • {{ITEM}} {{/EACH}} Relevant Permissions Requested: {{#EACH requested_permissions.accessibility}}

    • {{ITEM}} {{/EACH}}

  • Common Evaluation Matrix:

    Service ConfigurationReal Code UsageJustified?SeverityDirect Actionable Recommendation
    isAccessibilityTool="true"Code performs screen scraping, ad blocking, or automated click routines for standard users.No (Violation)CRITICALHigh Risk of Play Store Rejection: Remove accessibility helper configs. Migrate UI automation to standard Android testing libraries.
    isAccessibilityTool false/missingCode implements an accessibility listener but is not a dedicated helper app.No prominent disclosureCRITICALHigh Risk of Play Store Rejection: Because you request accessibility permission for a standard utility, you MUST implement an in-app Prominent Disclosure and Affirmative Consent screen before asking the user to enable the service, otherwise your app will be rejected.
  • Domain-Specific Heuristics (Strictly Bounded): Trace the ingestion of accessibility events:

    1. Telemetry Siphoning: Scan the Accessibility Service methods (onAccessibilityEvent). If the service captures on-screen text, notifications, or keystrokes and routes them to local caches, shared preferences, or off-device network logging endpoints, flag a CRITICAL violation under the Accessibility API policy. {{/IF_ALL}}

{{#IF_ALL requested_permissions.APPS_ON_DEVICE, data_sources.APPS_ON_DEVICE}}

Package Visibility (Policy ID: package_visibility_policy)
  • Goal: Evaluate if the app's core functionality justifies broad visibility into installed apps (QUERY_ALL_PACKAGES or related package APIs).

  • The Policy Spirit: The list of installed apps reveals sensitive user habits. The Play Store strictly restricts the QUERY_ALL_PACKAGES permission to apps that directly manage device safety (Antivirus, File Managers, Device Search).

  • Evidence: {{#EACH data_sources.APPS_ON_DEVICE}}

    • {{ITEM}} {{/EACH}} Relevant Permissions Requested: {{#EACH requested_permissions.APPS_ON_DEVICE}}

    • {{ITEM}} {{/EACH}}

  • Common Evaluation Matrix:

    Core App PurposePermission RequestedJustified?SeverityDirect Actionable Recommendation
    Antivirus, File Manager, or Device SearchQUERY_ALL_PACKAGESYes (Compliant)NoneNo action needed.
    Any AppQUERY_ALL_PACKAGESNo, used for ads, analytics, or secondary marketing.IMPORTANTHigh-Risk Violation: Remove the permission from the Manifest. Use specific <queries> intent declarations if package checks are strictly required for sharing/integration.
  • Domain-Specific Heuristics (Strictly Bounded): Examine indirect queries:

    1. Indirect Package Searching: Check if the code queries package details dynamically using PackageManager.getInstalledPackages() or checks intents in loops. If the intent lists are used to deduce if competitor apps or advertising profiles exist, flag an IMPORTANT violation of package visibility guidelines. {{/IF_ALL}}

{{#IF_ALL requested_permissions.SMS_CALL_LOG, data_sources.SMS_CALL_LOG}}

SMS and Call Log Permissions (Policy ID: sms_call_log_policy)
  • Goal: Evaluate if the app's core functionality justifies access to sensitive SMS or Call Log data.

  • The Policy Spirit: SMS and Call details are high-risk. Google Play restricts access to default phone handlers and default SMS handlers. Standard utility or shopping apps must use non-privileged APIs for SMS-based verification.

  • Evidence: {{#EACH data_sources.SMS_CALL_LOG}}

    • {{ITEM}} {{/EACH}} Relevant Permissions Requested: {{#EACH requested_permissions.SMS_CALL_LOG}}

    • {{ITEM}} {{/EACH}}

  • Common Evaluation Matrix:

    Code ContextFinding / Trigger CheckedSeverityDirect Actionable Recommendation
    OTP/Account VerificationApp requests SMS permissions to automatically read login verification codes (OTPs).IMPORTANTMigrate to the SMS Retriever API or SMS User Consent API which require zero permissions.
    Utility or Secondary FeatureApp requests SMS/Call log access for non-core dashboard or notification features.CRITICALHigh-Risk Violation: Completely remove SMS and Call Log permissions from the Manifest.
    Default SMS HandlerApp appears to be a legitimate handler (e.g. implements required intent filters).SUGGESTIONPlay Console Declaration: You must submit a Permissions Declaration Form in the Play Console and may be required to provide a video demonstration of this core functionality.
  • Domain-Specific Heuristics (Strictly Bounded): Audit background receivers:

    1. Background Incoming SMS Listeners: Check if a BroadcastReceiver listens to android.provider.Telephony.SMS_RECEIVED. If this receiver parses text in the background without being a designated default SMS handler, flag a CRITICAL violation.

    2. Default Handler Confirmation: If the app requests SMS/Call Log permissions and correctly implements the system-mandated intent filters for a Default Handler, flag a SUGGESTION to remind the developer about the mandatory Play Console declaration form. {{/IF_ALL}}

{{#IF_ALL requested_permissions.AUDIO, data_sources.AUDIO}}

Audio Recording Policy (Policy ID: audio_recording_policy)
  • Goal: Evaluate if the app's core functionality justifies broad access to audio recording.

  • The Policy Spirit: Unprompted audio recording is a severe privacy breach. Apps should request microphone access strictly for user-visible, time-bounded actions. Target SDK 34+ encourages using the system-managed Microphone Button for temporary needs.

  • Evidence: {{#EACH data_sources.AUDIO}}

    • {{ITEM}} {{/EACH}} Relevant Permissions Requested: {{#EACH requested_permissions.AUDIO}}

    • {{ITEM}} {{/EACH}} {{#IF TARGET_SDK}} Target SDK: {{TARGET_SDK}} {{/IF}}

  • Common Evaluation Matrix:

    Target SDKAudio Recording Trigger ContextSeverityDirect Actionable Recommendation
    34 or higherApp requests broad RECORD_AUDIO permission for occasional, user-initiated vocal input or short recording.IMPORTANTMigrate to the Android Microphone Button API to process temporary audio securely.
    AnyApp captures audio for secondary features (analytics, user-agent details, etc.) without explicit user control.IMPORTANTRemove microphone permissions. For general searches, integrate standard Android Speech Recognizer intents.
  • Domain-Specific Heuristics (Strictly Bounded): Verify recording indicators and threads:

    1. Continuous Capture: Scan for active recorder threads (AudioRecord or MediaRecorder). If recording loops can be active when the app is minimized or without a visible user-facing indicator, flag this as a CRITICAL violation. {{/IF_ALL}}

{{#IF_ALL requested_permissions.FILES_AND_DOCS, data_sources.FILES_AND_DOCS}}

Files and Docs Access Policy (Policy ID: files_and_docs_policy)
  • Goal: Evaluate if broad file access (non-media) is justified or if the Storage Access Framework should be used.

  • The Policy Spirit: Storage isolation (Scoped Storage) is mandatory on modern Android versions. Broad access to shared files is heavily restricted. Standard files, documents, and download folders should be navigated using scoped contracts to prevent global filesystem snooping.

  • Evidence: {{#EACH data_sources.FILES_AND_DOCS}}

    • {{ITEM}} {{/EACH}} Relevant Permissions Requested: {{#EACH requested_permissions.FILES_AND_DOCS}}

    • {{ITEM}} {{/EACH}} {{#IF TARGET_SDK}} Target SDK: {{TARGET_SDK}} {{/IF}}

  • Common Evaluation Matrix:

    Target SDKStorage ConfigurationJustified?SeverityDirect Actionable Recommendation
    30 or higherApp requests broad READ_EXTERNAL_STORAGE or WRITE_EXTERNAL_STORAGE for simple document selection.No (Violation)IMPORTANTScoped Storage Mandate: Migrate your document/file selections to the Storage Access Framework (SAF) (Intent.ACTION_OPEN_DOCUMENT).
  • Domain-Specific Heuristics (Strictly Bounded): Critique external directory creation:

    1. Manual File Sync Heuristic: Check if the code creates custom root-level folders on external storage (e.g. Environment.getExternalStorageDirectory() + "/my_folder"). If directories are created for standard document outputs or logging, flag an IMPORTANT violation. Direct the developer to utilize scoped storage paths. {{/IF_ALL}}

Output schema

Save final JSON output to {{TEMP_DIR}}/worker_{{GOAL_NAME}}.json.

{
  "domain": "Permissions and APIs",
  "findings": [
    {
      "policy_id": "STRING_VALUE (The exact Policy ID, e.g., photo_video_access_policy)",
      "issue_summary": "STRING_VALUE",
      "severity": "CRITICAL | IMPORTANT | SUGGESTION",
      "files_involved": ["STRING_VALUE"],
      "evidence": "STRING_VALUE",
      "recommendation": "STRING_VALUE"
    }
  ]
}

Requirements and compatibility

Works with: Claude Code, Claude apps, OpenAI Codex, GitHub Copilot, Cursor, Gemini CLI, Kiro, OpenCode, Goose, Amp, Roo Code, JetBrains Junie, Factory Droid, Devin (ex-Windsurf), Mistral Vibe, OpenHands, Letta

“Works with” means the tool reads the open Agent Skills format; a skill written for one tool may use features others lack.

Needs: Needs Python

Security

What our scanner noticed· Low risk

  • Scripts that your agent may run

This skill includes scripts that your agent may run. Read them before you use it.

A static scan is not a guarantee. Skills are third-party content: review a skill before you let an agent use it.

Attribution and licence

Created by
Google LLC
Publisher
Android (Google) (Official)
Distributed by
Android (Google)
Source
android/skills · play/play-policy-insights · commit bf68e2d
Licence
Apache License 2.0 (redistribution allowed)
  • LICENSE (added by AutoGineer from LICENSE.txt)
  • ATTRIBUTION.md (written by AutoGineer)
Synced

AutoGineer is not affiliated with or endorsed by Google LLC or Android (Google).

Download ZIP

The ZIP holds the skill’s files, its licence files and an ATTRIBUTION.md. Download play-policy-insights.zip