Diagnose Android Overheating
Overview
Find the most likely source of Android device heat by correlating thermal state, battery conditions, CPU activity, wakeups, radios, sensors, charging, and the user's timeline. Keep diagnosis read-only by default, distinguish evidence from inference, and propose only the smallest reversible intervention after the user approves it.
When to Use This Skill
- Use when an Android phone is hot, warm while idle, thermally throttled, shutting down from heat, or draining its battery unusually fast.
- Use when heat appears during charging, weak cellular signal, 5G use, navigation, camera use, gaming, media playback, tethering, or background activity.
- Use when the user wants to identify an offending app, service, wakelock, sensor, modem condition, or charging condition through ADB.
- Use when a previous Android optimization or debloat attempt may have left settings that changed power or thermal behavior.
- Use for physical phones and tablets. For profiling the energy use of an app under development, use an app-performance skill instead.
Safety Stop
Stop software diagnosis when the device shows battery swelling, smoke, hissing, leaking, a sharp chemical odor, repeated thermal shutdowns, or heat severe enough that it cannot be handled safely. Tell the user to disconnect power if this can be done safely, power the device off, keep it away from flammable material, and seek manufacturer or qualified repair support. Do not suggest cooling the device in a refrigerator or freezer, puncturing it, continuing to charge it, or running stress tests.
Diagnostic Contract
Before collecting data:
- Confirm the user owns or is authorized to inspect the device.
- Ask what “hot” means: location on the handset, activity, charging state, network type, onset, duration, and whether the heat also occurs while idle.
- Record the device model, Android version, recent OS/app changes, charger and cable, ambient conditions, and visible thermal warnings.
- Explain that an attached USB cable can charge and warm the device. Use wireless ADB or short capture windows when possible, and compare with the cable disconnected.
- Select a specific device serial when more than one ADB target is present. Never assume the first listed device is the intended phone.
Workflow
1. Capture an Untouched Baseline
Do not reset Batterystats, force-stop apps, clear caches, change network modes, alter AppOps, enable battery saver, or change developer settings before preserving the initial state.
Start with read-only commands:
adb devices -l
adb -s <serial> shell getprop ro.product.manufacturer
adb -s <serial> shell getprop ro.product.model
adb -s <serial> shell getprop ro.build.version.release
adb -s <serial> shell getprop ro.build.version.sdk
adb -s <serial> shell uptime
adb -s <serial> shell dumpsys battery
adb -s <serial> shell dumpsys thermalservice
adb -s <serial> shell dumpsys cpuinfo
adb -s <serial> shell top -n 1
If a service or option is unavailable, record that limitation. Do not turn missing output into a healthy verdict. Android and OEM builds expose different services, fields, permissions, and top syntax.
2. Choose the Evidence Branch
Read evidence-and-interpretation.md, then collect only the branches that match the symptom:
- heat while idle: battery history, power state, alarms, jobs, sensors, location, and radios;
- heat while charging: battery/USB state and a controlled unplugged comparison;
- heat under one app: process CPU, package memory, jobs, wakelocks, network, camera, and location;
- heat in weak signal or mobile data: telephony, connectivity, signal changes, and mobile-radio activity;
- heat during camera, navigation, gaming, or playback: CPU/GPU-adjacent state, display, camera/media, sensors, location, and network activity;
- heat after a setting change: capture current values and compare them with the known previous state before proposing rollback.
Do not collect a full bugreport unless narrow evidence is insufficient. Bugreports can contain account identifiers, app activity, network details, notifications, and other sensitive data.
3. Reproduce with a Controlled Comparison
Define one pass/fail comparison before changing anything. Examples:
- idle with airplane mode versus idle on weak cellular signal;
- same workload on Wi-Fi versus mobile data;
- charging versus unplugged after the battery level is stable;
- suspect app active versus closed by the user;
- screen on at fixed brightness versus screen off;
- before versus after the recent OS or app update, when a real reference exists.
Keep workload, duration, brightness, case, charger, ambient conditions, and starting battery level as constant as practical. Timestamp each observation. Avoid benchmarks or synthetic load unless the user explicitly asks and the device is not already thermally stressed.
4. Correlate, Do Not Guess
Require at
1---2name: diagnose-android-overheating3description: Use when diagnosing Android overheating, idle heat, thermal throttling, charging or radio heat, or abnormal battery drain with read-only ADB evidence and approval gates.4---5
6
7# Diagnose Android Overheating
8
9## Overview
10
11Find the most likely source of Android device heat by correlating thermal state, battery conditions, CPU activity, wakeups, radios, sensors, charging, and the user's timeline. Keep diagnosis read-only by default, distinguish evidence from inference, and propose only the smallest reversible intervention after the user approves it.
12
13## When to Use This Skill
14
15- Use when an Android phone is hot, warm while idle, thermally throttled, shutting down from heat, or draining its battery unusually fast.
16- Use when heat appears during charging, weak cellular signal, 5G use, navigation, camera use, gaming, media playback, tethering, or background activity.
17- Use when the user wants to identify an offending app, service, wakelock, sensor, modem condition, or charging condition through ADB.
18- Use when a previous Android optimization or debloat attempt may have left settings that changed power or thermal behavior.
19- Use for physical phones and tablets. For profiling the energy use of an app under development, use an app-performance skill instead.
20
21## Safety Stop
22
23Stop software diagnosis when the device shows battery swelling, smoke, hissing, leaking, a sharp chemical odor, repeated thermal shutdowns, or heat severe enough that it cannot be handled safely. Tell the user to disconnect power if this can be done safely, power the device off, keep it away from flammable material, and seek manufacturer or qualified repair support. Do not suggest cooling the device in a refrigerator or freezer, puncturing it, continuing to charge it, or running stress tests.
24
25## Diagnostic Contract
26
27Before collecting data:
28
291. Confirm the user owns or is authorized to inspect the device.
302. Ask what “hot” means: location on the handset, activity, charging state, network type, onset, duration, and whether the heat also occurs while idle.
313. Record the device model, Android version, recent OS/app changes, charger and cable, ambient conditions, and visible thermal warnings.
324. Explain that an attached USB cable can charge and warm the device. Use wireless ADB or short capture windows when possible, and compare with the cable disconnected.
335. Select a specific device serial when more than one ADB target is present. Never assume the first listed device is the intended phone.
34
35## Workflow
36
37### 1. Capture an Untouched Baseline
38
39Do not reset Batterystats, force-stop apps, clear caches, change network modes, alter AppOps, enable battery saver, or change developer settings before preserving the initial state.
40
41Start with read-only commands:
42
43```bash
44adb devices -l
45adb -s <serial> shell getprop ro.product.manufacturer
46adb -s <serial> shell getprop ro.product.model
47adb -s <serial> shell getprop ro.build.version.release
48adb -s <serial> shell getprop ro.build.version.sdk
49adb -s <serial> shell uptime
50adb -s <serial> shell dumpsys battery
51adb -s <serial> shell dumpsys thermalservice
52adb -s <serial> shell dumpsys cpuinfo
53adb -s <serial> shell top -n 1
54```
55
56If a service or option is unavailable, record that limitation. Do not turn missing output into a healthy verdict. Android and OEM builds expose different services, fields, permissions, and `top` syntax.
57
58### 2. Choose the Evidence Branch
59
60Read [evidence-and-interpretation.md](references/evidence-and-interpretation.md), then collect only the branches that match the symptom:
61
62- heat while idle: battery history, power state, alarms, jobs, sensors, location, and radios;
63- heat while charging: battery/USB state and a controlled unplugged comparison;
64- heat under one app: process CPU, package memory, jobs, wakelocks, network, camera, and location;
65- heat in weak signal or mobile data: telephony, connectivity, signal changes, and mobile-radio activity;
66- heat during camera, navigation, gaming, or playback: CPU/GPU-adjacent state, display, camera/media, sensors, location, and network activity;
67- heat after a setting change: capture current values and compare them with the known previous state before proposing rollback.
68
69Do not collect a full bugreport unless narrow evidence is insufficient. Bugreports can contain account identifiers, app activity, network details, notifications, and other sensitive data.
70
71### 3. Reproduce with a Controlled Comparison
72
73Define one pass/fail comparison before changing anything. Examples:
74
75- idle with airplane mode versus idle on weak cellular signal;
76- same workload on Wi-Fi versus mobile data;
77- charging versus unplugged after the battery level is stable;
78- suspect app active versus closed by the user;
79- screen on at fixed brightness versus screen off;
80- before versus after the recent OS or app update, when a real reference exists.
81
82Keep workload, duration, brightness, case, charger, ambient conditions, and starting battery level as constant as practical. Timestamp each observation. Avoid benchmarks or synthetic load unless the user explicitly asks and the device is not already thermally stressed.
83
84### 4. Correlate, Do Not Guess
85
86Require at
ranbot-ai