m5-onboard

Automate M5Stack ESP32 cold-start provisioning by flashing UIFlow 2.0 and installing MicroPython app bundles.

1|Updated Mar 30, 2026
One-click install
npx skills add https://github.com/Leap0920/Clean-Portfolio --skill m5-onboard-leap0920
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: m5-onboard
Source: https://github.com/Leap0920/Clean-Portfolio/tree/main/%25USERPROFILE%25/.openclaude/plugins/marketplaces/claude-plugins-official/plugins/cwc-makers/skills/m5-onboard
Command: npx skills add https://github.com/Leap0920/Clean-Portfolio --skill m5-onboard-leap0920

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires esptool, pyserial, and includes scripts (resource) and references (resource) components.

What problem does it solve?

It eliminates the repetitive, error-prone setup work required to get a freshly plugged-in M5Stack ESP32 device from blank/unknown state to a ready-to-run environment with the Claude Buddy MicroPython app bundle installed.

Core Features & Use Cases

  • End-to-end device provisioning: Detects the device on USB, selects the correct board variant, flashes UIFlow 2.0, and installs a shipped MicroPython app bundle onto /flash/.
  • Model-aware flashing: Uses a variant-driven approach (defaulting to Cardputer-Adv) to avoid boot-loop issues caused by flashing the wrong firmware image.
  • Recovery and maintenance workflows: Supports installing apps only (refresh), running an on-device smoke test (I2C/LCD/speaker/button verification), and provides guided physical steps when native-USB boards require a download-mode button dance.
  • Use Case: When you plug in a new Cardputer-Adv (or similar ESP32-based M5Stack device) and want it ready for Claude Buddy and other demo apps without manual flashing and file copying.

Quick Start

Tell the assistant: "m5-onboard go".

Frequently Asked Questions about m5-onboard

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I flash UIFlow 2.0 firmware onto a new M5Stack ESP32 device?

To flash UIFlow 2.0 firmware onto an M5Stack ESP32 device, you can automate the process by detecting the USB port and using esptool at the correct baud rates. This Skill handles the variant-driven firmware selection and flashing automatically.

What is the best way to provision multiple M5Stack devices for MicroPython apps?

The best way to provision multiple M5Stack devices is through an automated cold-start onboarding workflow. This process detects the board variant, flashes the firmware, and installs the MicroPython app bundle onto the device filesystem.

Why does my M5Stack Cardputer boot loop after flashing custom firmware?

A boot loop on an M5Stack Cardputer often occurs when flashing the wrong firmware image for the specific board variant. Using a model-aware variant-driven approach, defaulting to Cardputer-Adv, prevents these boot-loop issues.

Can I use esptool to install MicroPython apps directly onto an M5Stack flash?

Yes, you can install MicroPython apps onto an M5Stack by using paste-mode REPL file upload to copy the app bundle to the `/flash/` directory. This Skill automates the file upload process after flashing the device with esptool.

Do I need to press buttons to put native-USB M5Stack boards into download mode for flashing?

Yes, native-USB M5Stack boards require a physical button dance to enter download mode before flashing. This Skill provides guided physical steps to help you navigate the required button actions during the onboarding process.

How do I run a smoke test on an M5Stack device after provisioning?

To run a smoke test on an M5Stack device after provisioning, you can execute an on-device validation script. This verifies I2C, LCD, speaker, and button functionality to ensure the hardware is working correctly.