Low power debug
Use when debugging embedded sleep, standby, deep sleep, wakeup, current consumption, clock gating, lost debug access, or low-power mode failuresFrom its SKILL.md
npx -y skills add easyzoom/aix-skills --skill low-power-debugAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 24 stars24 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
SKILL.md
3.3 KB, 671 tokens by cl100k_base, as published. Nobody here has run it
Low Power Debug
Overview
Use this skill to debug low-power behavior by measuring current and wake sources before changing sleep configuration. Low-power bugs often involve board leakage, clocks, wake flags, debug settings, peripheral state, and firmware sequencing.
When To Use
Use this skill when:
- Current consumption is too high or unexpectedly low.
- The device fails to enter sleep, cannot wake, wakes immediately, or loses debug access.
- The task involves sleep, stop, standby, deep sleep, retention RAM, wake pins, RTC, watchdog, clock gating, or PMIC sequencing.
Do not use this skill when the board cannot boot at all; establish basic boot first.
First Questions
Ask for:
- Chip/board and intended low-power mode.
- Measured current, expected current, and measurement setup.
- Wake sources and whether wake flags are available.
- Debug probe attached or detached during measurement.
- Peripherals left enabled before sleep.
- Power rails, external devices, pull-ups, and board revision.
Workflow
-
Confirm measurement validity. Check meter range, sampling rate, burden voltage, shunt placement, rails included, and whether debugger/USB is attached.
-
Separate firmware from board leakage. Measure baseline board state, external devices, pull-ups, LEDs, regulators, and sensors.
-
Confirm intended sleep mode. Verify the actual mode entered, not just the API called.
-
Capture wake reason. Read wake flags immediately after wake before clearing them.
-
Disable peripherals methodically. Clocks, UART, ADC, timers, DMA, USB, radio, sensors, and pull configurations can dominate current.
-
Protect debug access. Warn that deep sleep may disconnect SWD/JTAG. Use timed wake, GPIO heartbeat, or connect-under-reset recovery.
Checks
- Debugger and semihosting disabled for current measurement.
- Unused GPIO configured to safe states.
- External pull-ups/pull-downs not causing leakage.
- Regulator and sensor quiescent currents accounted for.
- Wake pins polarity and pull state correct.
- RTC/LPTIM/watchdog clock source active if used.
- SRAM/retention domains configured intentionally.
- Interrupt flags cleared before sleep and read after wake.
Verification
Before claiming progress:
- State measured current, expected current, mode, and measurement setup.
- State whether debugger/USB was connected.
- Report actual wake source or wake flag evidence.
- List peripherals and rails still enabled.
- State recovery method if debug access may be lost.
Common Failures
- Measuring through USB while claiming battery current.
- Leaving the debugger attached and trusting sleep current.
- Clearing wake flags before reading them.
- Ignoring external sensors, pull-ups, LEDs, or regulators.
- Entering a shallower sleep mode than intended because a peripheral clock is active.
Example
User:
进入低功耗后电流还有 5mA,预期几十微安。
Agent:
- Asks for mode, current setup, rails measured, debugger state, wake sources, and board peripherals.
- Separates board leakage from MCU sleep current.
- Checks enabled clocks, GPIO states, regulators, and wake flags before code changes.
What ships with it
Read from the repository
Just SKILL.md. No reference files, no scripts.
Gives 0 of the 12 instructions most debug triage skills give in 671 tokens
Counted across 1,020 of the 1,639 authors here whose files we hold, read 2026-09-06
- Find root cause before attempting any fixin 134 of 1020, across 118 files
- Create a failing test case before implementing a fixin 109 of 1020, across 95 files
- Read error messages and stack traces completelyin 102 of 1020, across 88 files
- Reproduce the issue consistently before investigatingin 90 of 1020, across 77 files
- Make the smallest possible change to test a hypothesisin 90 of 1020, across 76 files
- Trace data flow backward to find the sourcein 84 of 1020, across 70 files
- Form a single hypothesis before testingin 78 of 1020, across 64 files
- Implement only one fix at a timein 76 of 1020, across 63 files
- Question the architecture if three fixes failin 73 of 1020, across 59 files
- Add diagnostic instrumentation at component boundariesin 68 of 1020, across 56 files
- Compare broken code against working examplesin 68 of 1020, across 57 files
- Write a regression test before applying the fixin 62 of 1020, across 55 files
Said here and by no other author read
- Measure current without debugger or USB attached
- Verify actual sleep mode entered
- Read wake flags before clearing them
- Disable peripherals methodically to isolate current draw
- Configure unused GPIO to safe states
- Account for external sensor and regulator leakage
Grouped from the skills themselves: near-identical wordings counted once, and counted by distinct author, so one author publishing three of these counts once. Length counted with cl100k_base; the agent that loads this file may tokenize it differently.