battery-selector — скилл для Claude Code: подбор батареи для ESP32
Скилл battery-selector помогает выбрать тип батареи и схему зарядки для проекта на Arduino, ESP32 или RP2040: от химии до расчёта ёмкости.
MIT 163 установок ★ 33 обновлён 2026-10-15
npx skills add wedsamuel1230/embedded-engineering-skills --skill battery-selector -a claude-codeЧто делает battery-selector
Скилл разбирает питание портативной поделки на Arduino, ESP32 или RP2040: какая химия подойдёт и чем её заряжать. Схема выбора задаёт три вопроса: нужна ли перезарядка, какое напряжение ждёт микроконтроллер, какой средний ток. Ответы ведут к вариантам вроде LiPo с boost-преобразователем или трёх NiMH.
Считать ёмкость вручную не надо. scripts/compare_batteries.py держит базу из 15+ типов и подбирает варианты по току и времени работы: --current 50 --hours 24, при желании с флагом --rechargeable. Скрипт запускается через uv run --no-project, поэтому на машине без uv калькулятор не поедет, останется только текстовая часть.
Второй файл, references/safety-guidelines.md, — правила обращения с каждой химией. Для LiPo там прямой список: не заряжать ниже 0 °C, не разряжать ниже 3.0V, не брать вздутые банки. По зарядке скилл советует модуль TP4056 с защитой, у него 6 контактов, а не 4.
Какие задачи решает
- подобрать химию батареи под проект на ESP32
- посчитать ёмкость по среднему току и времени работы
- выбрать схему зарядки для LiPo
- свериться с правилами безопасности перед пайкой аккумулятора
- сравнить alkaline, NiMH и LiFePO4 по напряжению и ресурсу
Примеры запросов агенту
- Какая батарея нужна для ESP32 с датчиком, который должен работать сутки?
- Подбери аккумулятор под 100 мА и 12 часов, только перезаряжаемый.
- Можно ли запитать Arduino Nano от одного LiPo и как его заряжать?
Как установить battery-selector
1Через Skills CLI (Vercel)
npx skills add wedsamuel1230/embedded-engineering-skills --skill battery-selector -a claude-code2Вручную: положить файлы
~/.claude/skills/battery-selector/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/battery-selector/
1Через Skills CLI (Vercel)
npx skills add wedsamuel1230/embedded-engineering-skills --skill battery-selector -a codex2Вручную: положить файлы
.agents/skills/battery-selector/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add wedsamuel1230/embedded-engineering-skills --skill battery-selector -a cursor2Вручную: положить файлы
.cursor/skills/battery-selector/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install wedsamuel1230/embedded-engineering-skills skills/battery-selector2Вручную: положить файлы
.github/skills/battery-selector/SKILL.md1Через Skills CLI (Vercel)
npx skills add wedsamuel1230/embedded-engineering-skills --skill battery-selector -a gemini-cli2Командой платформы
gemini skills install https://github.com/wedsamuel1230/embedded-engineering-skills --path skills/battery-selectorВручную: положить файлы
.devin/skills/battery-selector/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add wedsamuel1230/embedded-engineering-skills --skill battery-selector -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о battery-selector
Как установить battery-selector в Claude Code?
Выполните npx skills add wedsamuel1230/embedded-engineering-skills --skill battery-selector -a claude-code. Файл скилла появится по пути ~/.claude/skills/battery-selector/SKILL.md.
Что делает battery-selector?
Помогает выбрать тип элемента питания и схему зарядки для встраиваемых проектов: разбирает химию, напряжение и ток. В комплекте идёт калькулятор батарей и памятка по безопасности.
Что нужно, чтобы запустить калькулятор батарей?
Установленный uv: скрипт вызывается как uv run --no-project scripts/compare_batteries.py --current 50 --hours 24. Без него останутся только текстовые рекомендации скилла.
Исходный текст
SKILL.md · MIT
---
name: battery-selector
description: Helps choose the right battery type and charging solution for Arduino/ESP32/RP2040 projects. Use when user asks about battery options, charging circuits, power source selection, or says "what battery should I use". Covers chemistry selection, safety, voltage regulation, and charging circuits.
metadata: {triggers: "battery choice, charging circuit, power source, battery life"}
---
# Battery Selector
Guides battery chemistry and charging circuit selection for embedded projects.
## Resources
This skill includes bundled tools and references:
- **scripts/compare_batteries.py** - Battery comparison calculator with 15+ battery types
- **references/safety-guidelines.md** - Comprehensive safety guide for all chemistries
## Quick Start
**Interactive selection:**
```bash
uv run --no-project scripts/compare_batteries.py --interactive
```
**Command line:**
```bash
# Find battery for 50mA project, 24h runtime
uv run --no-project scripts/compare_batteries.py --current 50 --hours 24
# Require rechargeable
uv run --no-project scripts/compare_batteries.py --current 100 --hours 12 --rechargeable
# List all batteries in database
uv run --no-project scripts/compare_batteries.py --list
```
## When to Use
- "What battery should I use?"
- "How do I charge this project?"
- "Lithium vs alkaline?"
- "Is this battery safe?"
- Planning portable/battery-powered projects
## Decision Flowchart
```
START
│
▼
Is project rechargeable? ──No──► Alkaline/Lithium Primary
│ (Disposable batteries)
Yes
│
▼
What voltage does MCU need?
│
├── 5V ──► LiPo + Boost converter
│ OR 3x/4x NiMH
│
├── 3.3V ──► Single LiPo (3.0-4.2V)
│ Directly compatible!
│
└── 12V+ ──► Multi-cell LiPo pack
OR Lead-acid
│
▼
How much current?
│
├── <50mA ──► Small LiPo (500-1000mAh)
│ OR Coin cell (CR2032)
│
├── 50-500mA ──► Standard LiPo (1000-3000mAh)
│ OR 18650 cells
│
└── >500mA ──► Large LiPo (3000mAh+)
OR Multiple 18650s
External power recommended
```
## Battery Chemistry Comparison
### Quick Reference
| Chemistry | Voltage | Rechargeable | Energy Density | Cost | Safety |
|-----------|---------|--------------|----------------|------|--------|
| Alkaline | 1.5V/cell | No | Medium | Low | Very safe |
| Lithium Primary | 3V | No | High | Medium | Safe |
| NiMH | 1.2V/cell | Yes | Medium | Medium | Safe |
| LiPo/Li-ion | 3.7V | Yes | Very High | Medium | ⚠️ Needs care |
| LiFePO4 | 3.2V | Yes | High | High | Safer than LiPo |
| Lead-acid | 2V/cell | Yes | Low | Low | ⚠️ Acid hazard |
### Alkaline (AA/AAA/9V)
**Pros:**
- Cheap, available everywhere
- No charging circuit needed
- Very safe
- Long shelf life (5-10 years)
**Cons:**
- Not rechargeable (e-waste!)
- Voltage drops as discharged
- Poor at high current
- Heavy for capacity
**Best For:**
- Low-power projects (<20mA average)
- Beginner projects
- Remote/deployment where charging impractical
- Backup power
**Voltage Configurations:**
```
Cells Voltage Use With
────────────────────────────
2x AA 3.0V 3.3V MCUs (with LDO)
3x AA 4.5V 5V MCUs (direct or LDO)
4x AA 6.0V 5V MCUs (with regulator)
9V 9.0V With 5V/3.3V regulator
```
---
### NiMH (AA/AAA Rechargeable)
**Pros:**
- Rechargeable (500-1000 cycles)
- Same size as alkaline
- Safer than lithium
- No memory effect
**Cons:**
- Lower voltage (1.2V vs 1.5V)
- Self-discharge (~20%/month)
- Need proper charger
- Heavier than LiPo
**Best For:**
- Projects replacing disposable batteries
- Educational settings
- Where LiPo is too risky
- Budget rechargeable solution
**Charging:**
- Use dedicated NiMH charger
- Don't mix brands/capacities
- Eneloop/Eneloop Pro recommended
---
### LiPo / Li-ion (3.7V)
**Pros:**
- High energy density (light + powerful)
- Rechargeable (300-500 cycles)
- Flat discharge curve
- Many form factors
**Cons:**
- ⚠️ Fire risk if abused
- Needs protection circuit
- Temperature sensitive
- Ages even unused
**Best For:**
- Most portable projects
- Weight-sensitive applications
- When you need runtime
- Professional builds
**Critical Safety Rules:**
```
✅ DO:
- Use protected cells with BMS
- Store at 40-60% charge
- Use proper TP4056/similar charger
- Monitor temperature during charge
- Use battery with JST-PH connector (prevents polarity swap)
❌ DON'T:
- Puncture, crush, or bend
- Charge below 0°C
- Discharge below 3.0V
- Leave charging unattended (first few times)
- Use damaged/puffy batteries
```
---
### LiFePO4 (3.2V)
**Pros:**
- Much safer than LiPo (no thermal runaway)
- Longer cycle life (2000+ cycles)
- Flat discharge curve
- Tolerates abuse better
**Cons:**
- Lower energy density
- Lower voltage (may need boost)
- More expensive
- Less common in small sizes
**Best For:**
- Safety-critical applications
- Outdoor/rugged deployments
- Long-term installations
- When LiPo risk unacceptable
---
### CR2032 / Coin Cells
**Pros:**
- Tiny and light
- Long shelf life
- 3V output (direct to 3.3V MCU)
**Cons:**
- Very low capacity (220mAh)
- Poor high-current performance
- Not rechargeable
- ⚠️ Danger if swallowed
**Best For:**
- Ultra-low power only (<10µA average)
- RTC backup
- Tiny sensors
- Keyfobs, beacons
**Current Limits:**
```
Continuous: <2mA
Pulse: <15mA (brief)
DON'T use for: WiFi, Bluetooth, motors, LEDs
```
---
## Voltage Regulation
### 3.3V Systems (ESP32, RP2040)
**Single LiPo → 3.3V:**
```
LiPo outputs 3.0-4.2V
Most 3.3V MCUs tolerate this range directly!
Option 1: Direct connection (if MCU allows)
LiPo(+) → 3.3V/VIN pin
Option 2: LDO for clean 3.3V
LiPo(+) → [AMS1117-3.3] → 3.3V pin
(Need 4V min input for AMS1117)
Better: Use HT7333 LDO (low dropout, low quiescent)
Works from 3.3V input!
```
### 5V Systems (Arduino UNO/Nano)
**LiPo → 5V:**
```
Option 1: Boost converter
LiPo(+) → [MT3608] → 5V → VIN pin
Option 2: PowerBoost module (Adafruit)
Includes charging + boost + protection
Option 3: USB power bank
Already regulated 5V + charging built-in
```
---
## Charging Solutions
### TP4056 Module (Most Popular)
```
┌─────────────────────────────┐
│ TP4056 with Protection │
│ │
│ [USB-C] ─► [TP4056] ─► [DW01+FS8205] ─► [B+/B-]
│ IN Charger Protection To Battery
│ │
│ Features: │
│ - 1A max charge current │
│ - Overcharge protection │
│ - Overdischarge protect │
│ - Short circuit protect │
│ - LED charge indicator │
└─────────────────────────────┘
Wiring:
B+ → LiPo positive
B- → LiPo negative
OUT+ → Load/MCU positive
OUT- → Load/MCU negative
```
**⚠️ Get module WITH protection (6 pins, not 4 pins)**
### Adafruit PowerBoost 500C/1000C
Premium solution with:
- LiPo charging via USB
- 5V boost output (500mA or 1A)
- Low battery indicator
- Load sharing (charge while running)
### DIY Charging Don'ts
```
❌ Never charge LiPo with a constant voltage supply
❌ Never charge LiPo with a phone charger directly
❌ Never charge at >1C rate (e.g., 1000mAh → max 1A)
❌ Never charge frozen batteries
```
---
## Battery Sizing Calculator
```
Step 1: Determine average current (from power-budget-calculator)
I_avg = _____ mA
Step 2: Determine required runtime
T_required = _____ hours
Step 3: Calculate minimum capacity
C_min = I_avg × T_required × 1.25 (safety factor)
C_min = _____ × _____ × 1.25
C_min = _____ mAh
Step 4: Select battery
Choose capacity ≥ C_min
Consider: size, weight, form factor
```
**Example:**
```
Project: Weather station
I_avg: 15mA
T_required: 48 hours (2 days between charges)
C_min = 15 × 48 × 1.25 = 900mAh
Selection: 1000mAh LiPo (gives ~67 hours actual)
```
---
## Common Mistakes
### 1. Using Wrong Charger
```
❌ "My 9V adapter should work"
LiPo needs CC-CV charging at 4.2V max!
✅ Use TP4056 or dedicated LiPo charger
```
### 2. No Low-Voltage Cutoff
```
❌ Draining LiPo below 3.0V
Permanently damages the cell!
✅ Use protection module OR monitor in code:
if (batteryVoltage < 3.2) {
enterDeepSleep(); // Protect battery
}
```
### 3. Ignoring Inrush Current
```
❌ Battery can't handle WiFi TX spike (500mA)
Causes brownout/reset
✅ Add 100-470µF capacitor near MCU
✅ Size battery for peak current, not just average
```
### 4. No Reverse Polarity Protection
```
❌ Swapping battery wires = magic smoke
✅ Use JST-PH connectors (keyed)
✅ Add protection diode or P-FET
```
---
## Recommended Setups by Project Type
### Low-Power Sensor Node
```
Battery: 18650 (3000mAh) or LiPo 2000mAh
MCU: ESP32 with deep sleep
Charger: TP4056 with protection
Runtime: Weeks to months
```
### Handheld Device
```
Battery: LiPo 1000-2000mAh flat pack
MCU: Any
Charger: PowerBoost or TP4056 + boost
Runtime: Hours to days
```
### Robot/High Current
```
Battery: 2S or 3S LiPo pack (7.4V or 11.1V)
Regulator: Buck converter to 5V
Charger: Balance charger (external)
Runtime: Minutes to hours
```
### Ultra-Low Power Beacon
```
Battery: CR2032 or 2x AA
MCU: ESP32-C3 or ATtiny with deep sleep
No charger needed
Runtime: Months to years
```
## Quick Selection Table
| Project Type | Best Battery | Capacity | Charger |
|--------------|--------------|----------|---------|
| Simple Arduino | 4x AA | 2500mAh | None |
| ESP32 portable | 18650 | 2600mAh | TP4056 |
| Wearable | Small LiPo | 500mAh | TP4056 |
| Robot | 2S LiPo | 2200mAh | Balance |
| Ultra-low power | CR2032 | 220mAh | None |
| Solar project | LiFePO4 | 3200mAh | MPPT |
## Shared Output Contract
Use [the shared Arduino skill contract](../../docs/arduino-skill-contract.md):
state assumptions, required tools and versions, implementation steps,
tests/evidence by proof stage, known limitations, and recovery/security notes.
© wedsamuel1230 · MIT · wedsamuel1230/embedded-engineering-skills