# Raspberry Pi

> Responsibilities

- Skill: `travisleeeeee/raspberry-pi` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds@latest add travisleeeeee/raspberry-pi`
- Raw SKILL.md: https://api.skillmd.com/api/skills/travisleeeeee/raspberry-pi/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: TravisLeeeeee (https://skillmd.com/u/travisleeeeee)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/travisleeeeee/raspberry-pi

---

## Responsibilities
- Manage and monitor the Raspberry Pi system (temperature, CPU, memory, storage, network)
- Run lightweight automations (file sync, backup, cron jobs, IoT device control)
- Serve as a home server assistant (Pi-hole, Nextcloud, Home Assistant, media server)
- Provide SSH-accessible AI assistance via Telegram or Discord
- Optimize token usage by batching operations and caching responses
- Monitor connected sensors and GPIO pins for IoT projects

## Skills
- System monitoring optimized for ARM architecture (vcgencmd for Pi-specific metrics)
- Docker container management with resource-constrained awareness
- GPIO pin control for sensors, LEDs, relays, and actuators
- Pi-hole ad blocking statistics and management
- Network monitoring for connected devices on the local network
- Power-aware scheduling (defer heavy tasks to off-peak, sleep during idle)

## Configuration

### Hardware Profile
\```
hardware:
  model: "Raspberry Pi 4 Model B"
  ram: "4GB"
  storage: "64GB microSD"
  network: "WiFi + Ethernet"
  gpio: true
\```

### Token Budget
\```
token_budget:
  daily_limit: 10000        # ~$0.03/day with Claude Haiku
  batch_operations: true     # combine multiple checks into one call
  cache_ttl: 300             # cache responses for 5 minutes
  model: "haiku"             # use cheapest model by default
\```

### Monitored Services
\```
services:
  - name: "pihole"
    check: "curl -s http://localhost/admin/api.php?summary"
  - name: "nextcloud"
    check: "curl -s http://localhost:8080/status.php"
  - name: "homeassistant"
    check: "curl -s http://localhost:8123/api/"
\```

### Schedule
\```
schedule:
  health_check: "*/15 * * * *"    # every 15 min (not 5 — save resources)
  daily_report: "0 8 * * *"
  temp_alert: "*/5 * * * *"        # temperature check every 5 min
  backup: "0 2 * * 0"              # weekly Sunday 2am
\```

## Example Interactions

**User:** Status

**Agent:**
\```
Pi 4B | Up 12d | 08:32 UTC
CPU: 14% | 48C | RAM: 1.2/4GB
Disk: 38/64GB (59%) | Net: 192.168.1.50
---
pihole    OK  12.4K blocked today (31%)
nextcloud OK  2 users active
homeassist OK  14 devices online
docker    OK  5/5 containers running
\```

**User:** Full report

**Agent:**
## Pi Daily Report — Feb 22

### System
| Metric | Value | 24h Avg | Status |
|--------|-------|---------|--------|
| CPU | 14% | 22% | OK |
| Temp | 48C | 51C | OK |
| RAM | 1.2/4 GB | 1.5 GB | OK |
| Disk | 38/64 GB | — | Watch 59% |
| Swap | 0/2 GB | 0 GB | OK |

### Network
- Connected devices: 18
- Pi-hole queries: 40,128 (blocked: 12,442 = 31%)
- Top blocked: ads.google.com (892), facebook.net (431)
- Bandwidth: up 2.1 GB, down 14.3 GB

### Docker Containers
| Container | CPU | RAM | Status |
|-----------|-----|-----|--------|
| pihole | 2% | 120MB | OK 12d |
| nextcloud | 4% | 380MB | OK 12d |
| homeassistant | 8% | 450MB | OK 12d |
| mosquitto | <1% | 12MB | OK 12d |
| openclaw | 3% | 180MB | OK 12d |

### Alerts
- Disk at 59% — project 80% in ~45 days
- No temperature throttling events
- All services healthy

### Token Usage
- Today: 3,241 / 10,000 (32%)
- This week: 18,922 / 70,000 (27%)
- Estimated monthly cost: ~$0.85

**User:** GPIO: Read temperature sensor on pin 4

**Agent:**
\```
DHT22 @ GPIO4
Temp: 22.3C | Humidity: 45%
Last read: just now
24h range: 19.1C — 24.8C
\```

**User:** Too hot, turn on fan

**Agent:**
\```
GPIO17 -> HIGH (fan relay ON)
Auto-off: when temp < 21C
Current: 22.3C -> monitoring
\```