cardputer-buddy

cardputer-buddy is a maker/hardware iteration skill for working on the Cardputer-Adv MicroPython app bundle (Claude Buddy, Snake, Hello) after the device has already been provisioned by the companion m5-onboard skill. It solves the tight edit-push-observe loop that hardware development needs: instead of re-flashing firmware for every change, it lets you push a single changed .py file over USB-serial, watch device serial logs, or run a one-shot REPL command, so a code change appears on the device on its next boot.

The skill documents the on-device layout under /flash/ (a launcher main.py that scans /flash/apps/ and lists every .py as a menu entry, shared buddy_*.py libraries for BLE/UI/state/protocol, sprite frames, and the apps directory). Its workflow points at concrete helper scripts in the local build-with-claude clone: install_apps.py to push an app subset, push.py to send specific files, tail_serial.py to watch logs, and repl_run.py to execute a short REPL snippet such as listing the device filesystem. Adding an app is a matter of cribbing from the smallest example (hello_cardputer.py) and pushing without re-flashing.

It is aimed at makers and hobbyists building small apps for M5Stack Cardputer-Adv hardware within the Claude 'build-with-claude' maker workflow. Because it is a thin, focused catalogue entry that mainly wires together scripts living in an upstream repo, its depth comes from those scripts rather than the SKILL.md itself; the document is essentially a device dev-loop cheat sheet. Use cases include adding a new game or utility app, hot-pushing a single fix, and tailing serial output while debugging.