Play Policy Insights
Android (Google)OfficialCreated by Google LLCDistributed by Android (Google)
- Skill
- Review and audit
- Security
- Apache-2.0
- Low risk
- Has scripts
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
Download the skill as a ZIP:
https://autogineer.com/agent-skills/android/play-policy-insights/downloadUnzip 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, orspawn_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.pyfails, 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
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.
Capture environment: Note values of the
temp_dir, andactivated_goalsfrom the JSON output. You will need them in Phase 2.Evaluate goals: If
activated_goalsis 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)
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>.jsonexists 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.Aggregate Findings: Execute the python aggregation command:
python3 <repo_root>/scripts/orchestrator.py aggregate <temp_dir>. This producesaggregated_findings.jsonand returns a JSON object containingcritic_chunksrepresenting the number of chunks to verify (e.g.,{"temp_dir": "...", "critic_chunks": 2}).Parallel Critic review: For each chunk index
ifrom 1 tocritic_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>.jsonexists 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.Proceed to Finalization (Step 4 below)
Mode B: Orchestrator WITHOUT Delegation Capabilities (Sequential)
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>.jsonexists before moving to the next goal.
Aggregate Findings: Execute the python aggregation command:
python3 <repo_root>/scripts/orchestrator.py --aggregate <temp_dir>. This producesaggregated_findings.jsonand returns a JSON object containingcritic_chunksrepresenting the number of chunks to verify.Sequential Critic review: For each chunk index
ifrom 1 tocritic_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>.jsonexists before moving to the next chunk.
Proceed to Finalization (Step 4 below)
Finalization (Both Modes)
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.STOP: The audit is complete. Await further instructions.
Files
- ATTRIBUTION.mdAdded by AutoGineer967 B
- LICENSELicence file added by AutoGineer11.1 KiB
- SKILL.md8.3 KiB
- resources/common_mandates.md6.0 KiB
- resources/compliance_report_template.md3.1 KiB
- resources/critic.md4.2 KiB
- resources/goal_data_safety.md10.2 KiB
- resources/goal_permissions_and_apis.md25.7 KiB
- resources/goal_user_account.md5.1 KiB
- resources/policies.json12.9 KiB
- resources/scanner_config.json25.5 KiB
- scripts/generate_report.pyScript27.7 KiB
- scripts/orchestrator.pyScript44.9 KiB
- scripts/play_store_scraper.pyScript12.0 KiB
- scripts/scanner.pyScript8.8 KiB
- scripts/template_engine.pyScript7.0 KiB
resources/goal_data_safety.md
{{#IF_ANY data_sources, disclosure}} {{ACTIVATE_GOAL}} {{/IF_ANY}}
Data Safety and Privacy Audit
Policies to Verify
The Policy Spirit: Users deserve complete transparency regarding what personal or sensitive information leaves their devices. Under Play Store rules, any off-device transmission of user data must be explicitly declared in the Play Store Data Safety form, and sensitive or non-obvious data collection requires prior prominent in-app disclosure and affirmative user consent.
Common Evaluation Matrix:
Case Technical Observation user_initiatedis_third_partyDisclosure Status Severity Issue Summary 1 Not Transferred (Local only) N/A N/A EXEMPTSUGGESTION"Data Safety Compliant (Local-Only)" 2A Transferred + Background + No Disclosure false(Any) MISSINGCRITICAL"Silent Background Transfer": Policy violation. Data is sent without prior disclosure. 2B Transferred + Background + Disclosure Found false(Any) DISCLOSEDIMPORTANT"Background Transfer (Disclosure Claimed)": Evidence found; requires Critic verification. 3 Transferred + User-Initiated + First Party truefalseEXEMPTIMPORTANT"User-Initiated Collection": Disclosure exempt, but must be declared in Play Store form. 4 Transferred + User-Initiated + Third Party truetrueEXEMPTSUGGESTION"Manual Sharing": Policy Exempt. User triggers transfer to 3P; no disclosure or declaration needed. Exemptions Reference:
Anonymous Data: Fully anonymized data not linked to a user is exempt.
End-to-End Encryption (E2EE): Data E2EE where the developer cannot read it is exempt.
Open Web WebView: Data entered into a WebView navigating the open web is exempt.
If any of these apply, downgrade severity to
SUGGESTIONand markEXEMPT.
The Audit Protocol
Step 0: Facts orientation
Identify Third-Party SDKs: If you observe network, crash-reporting, or tracking telemetry, check the project's build files (e.g., build.gradle, build.gradle.kts, libs.versions.toml) on-demand using your file-reading tools to verify which SDKs (Analytics, Ads, etc.) are integrated.
Understand Off-Device Sinks: Use your native knowledge of standard Android framework components to identify transmission destinations. Focus on active egress vectors such as standard HTTP/REST libraries (e.g., OkHttp, Retrofit, Ktor, HttpURLConnection), WebViews passing data off-device, background syncing tasks, or analytic/telemetry frameworks (e.g., Firebase, Mixpanel, Adjust, AppsFlyer).
Identify Disclosures: Review
disclosurebelow. Use these as starting points for Step 2.
Step 1: Verify behavioral transmission (Forward Trace)
For each source in data_sources listed below, trace the technical signal from
the exact location provided to its transmission endpoint.
Mandatory Starting Point: Navigate to the file and line number specified in the
data_sourceslist.Loop Discipline: You must analyze the transmission path for every piece of evidence listed to verify if it reaches an off-device sink.
Evidence: Provide the file/line where the data is passed to the sink and a brief justification of the sink's known transmission behavior (e.g., network upload, telemetry payload).
Semantic Grounding: Use the provided
*Description*to verify that the code evidence actually matches the semantic scope of the data type. If the variable or logic refers to unrelated data (e.g., afileNamethat does not identify a userNAME), treat it as a false positive and follow the Evidentiary Standard to downgrade or prune the finding.Sink Categorization: Determine the destination:
First Party / Service Provider (
is_third_party: false): Developer-controlled servers, Firebase, custom APIs, etc.Third Party (
is_third_party: true): Social SDKs, ad networks, or user-selected apps via Android Share Sheet (Intent.ACTION_SEND).
Ambiguity Mandate: If the destination is ambiguous (e.g., generic URL or obfuscated SDK), you MUST default to
is_third_party: false(erring on the side of Collection).On-Device Transfer: Treat silent data sharing to another app via Intents/ContentProviders as a transfer (
is_transferred: true), even if it doesn't use the network.
Step 2: Semantic Search for Protection (UI Disclosure)
Conditional Execution: Execute this step ONLY IF is_transferred is
true AND user_initiated is false.
Rationale: User-initiated actions (Case 3 and 4) are exempt from Prominent Disclosure. Do not search for disclosures if
user_initiatedis true.Semantic Search: Review the
disclosurelist below.Gatekeeper Check: Check if the Activity/Fragment displaying that consent acts as a gatekeeper (i.e., gates the initialization of the data-collection logic). Do not attempt to trace backwards from a low-level repository up to the UI.
Content Check: The UI must state what is collected and how it is used.
Evidence: Provide the file/layout name and the specific text found.
Step 3: Synthesis
findings(CRITICAL): You must construct and output exactly one object inside the"findings"array for every data type found in thedata_sourceslist below, regardless of whether it is compliant or a violation.Evaluating Keys: For each data type object in
"findings", evaluate and populate:psl_constant: Set this exactly to the uppercase PSL Constant of the data type (listed as the Data Type heading in the Data Sources to Trace section below, e.g.,
"PRECISE_LOCATION","CONTACTS"). This is critical for downstream matching.policy_id: Set this exactly to either
"prominent_disclosure_policy"or"data_safety_section"depending on the check being performed.is_transferred:
true(JSON Boolean) if the data is transferred off-device or on-device to a third party.false(JSON Boolean) if local only.user_initiated:
true(JSON Boolean) if the user explicitly triggers the transfer.is_third_party:
true(JSON Boolean) if the destination is a Third Party (e.g., Share Sheet, Social SDK).false(JSON Boolean) if it's a First Party/Service Provider (e.g., your own backend).prominent_disclosure_status: Set strictly to one of these three uppercase enums:
"DISCLOSED"(visible disclosure and user consent found),"MISSING"(no disclosure found, or is not an affirmative gatekeeper), or"EXEMPT"(exempt from prominent disclosure under policies).purpose: Categorize why the data is being collected (e.g., "App functionality", "Analytics", "Local functionality only").
linked_to_user:
true(JSON Boolean) if the data is tied to an identity, email, or device ID, otherwisefalse(JSON Boolean).
Map findings strictly to the 5 Cases: Use the Case matrix in "Policies to Verify" to set the appropriate
severityandissue_summarybased on the combination ofis_transferred,user_initiated,is_third_party, andprominent_disclosure_status.
Domain-Specific Heuristics
Apply the following heuristics while strictly adhering to the Heuristics & Extrapolation Boundaries defined in your Execution Mandates:
Implicit Data Leaks (The Logger Loop): Inspect if any custom logging frameworks (e.g., Crashlytics, custom error loggers, or telemetry SDKs) receive sensitive variables as part of diagnostic payloads. If a user identifier (e.g., email, account ID) or precise location is passed to a logger that uploads payloads off-device, this counts as transferred (
is_transferred: true).Third-Party SDK Siphoning: Look at the project's build files on-demand (e.g., build.gradle or libs.versions.toml). If SDKs like Google Ads, or Firebase are initialized and have access to the context, evaluate if they are siphoning advertiser IDs or device identifiers automatically. If those libraries are loaded and the manifest requests broad network permissions, treat those device identifiers as transferred (
is_transferred: true) for analytics/marketing purposes.Indirect Consent: If you find an
AlertDialogor disclosure, verify if it is an actual gatekeeper. If the app begins tracking user data prior to the user tapping "Accept", or if the user can close the dialog and continue using the app while data tracking remains active, flag this as aCRITICALviolation underprominent_disclosure_policy.
Codebase Context & Evidence
{{#IF semantic_files.LEGAL}} Semantic Triage Starting Points (Files of Interest): The following files likely contain privacy or consent logic:
LEGAL related: {{#EACH semantic_files.LEGAL}}
{{ITEM}}{{/EACH}} {{/IF}}
{{#IF data_sources}} Data Sources to Trace: {{#EACH data_sources}}
Data Type: {{KEY}} Description: {{VALUE.description}} {{#EACH VALUE.findings}}
{{ITEM}}{{/EACH}} {{/EACH}} {{/IF}}
{{#IF disclosure}} UI Disclosure Starting Points: {{#EACH disclosure}}
{{ITEM}}{{/EACH}} {{/IF}}
Output schema
Save final JSON output to {{TEMP_DIR}}/worker_{{GOAL_NAME}}.json.
{
"domain": "Data Safety and Privacy",
"findings": [
{
"psl_constant": "STRING_VALUE (The exact PSL Constant, e.g., USER_ACCOUNT)",
"policy_id": "prominent_disclosure_policy | data_safety_section",
"issue_summary": "STRING_VALUE",
"severity": "CRITICAL | IMPORTANT | SUGGESTION",
"files_involved": ["STRING_VALUE"],
"evidence": "STRING_VALUE",
"recommendation": "STRING_VALUE",
# UNIFIED DATA SAFETY METADATA LOOKUP KEYS:
"is_transferred": true | false,
"user_initiated": true | false,
"is_third_party": true | false,
"prominent_disclosure_status": "DISCLOSED | MISSING | EXEMPT",
"purpose": "STRING_VALUE",
"linked_to_user": true | false
}
]
}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