m5-onboard

Provision M5Stack/ESP32 boards by flashing UIFlow 2.0 and installing the Claude Buddy app bundle.

28|5|Updated Jun 24, 2025
One-click install
npx skills add https://github.com/thevibeworks/claude-code-docs --skill m5-onboard
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: m5-onboard
Source: https://github.com/thevibeworks/claude-code-docs/tree/main/content/github/claude-plugins-official/plugins/cwc-makers/skills/m5-onboard
Command: npx skills add https://github.com/thevibeworks/claude-code-docs --skill m5-onboard

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

It solves the hassle of manually provisioning a freshly connected M5Stack/ESP32 board by automating detection, firmware flashing, and installing the Claude Buddy MicroPython app bundle.

Core Features & Use Cases

  • End-to-end device onboarding: Detects the board on USB, flashes UIFlow 2.0 firmware, and installs the buddy app set onto the device for immediate use.
  • Model-aware firmware provisioning: Uses variant handling (e.g., Cardputer-Adv default, prompts when ambiguous) to avoid boot-loop mistakes from flashing the wrong image.
  • Recovery-oriented workflow: Supports installing/refetching apps on already-flashed devices and running a smoke test when hardware behavior looks off.

Use case: You plug in a Cardputer-Adv at an event and need it ready for Claude Buddy over BLE immediately—run the skill to provision it consistently without manual file uploads or firmware guesswork.

Quick Start

Ask Claude Code to run m5-onboard go to detect your M5Stack device, flash UIFlow 2.0, and install the Claude Buddy app bundle.

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 and install MicroPython apps on an M5Stack automatically?

Yes, it supports device recovery by refetching and installing apps on already-flashed boards and running smoke tests to verify hardware behavior when the device is not functioning correctly.

Can I provision an M5Stack device for BLE provisioning on macOS, Linux, and Windows?

To provision an M5Stack Cardputer for Claude Buddy, plug the device into USB and trigger the skill to automatically detect the variant, flash UIFlow 2.0 firmware, and install the MicroPython app bundle for immediate BLE communication.

How do I handle ESP32-S3 download-mode button coaching for M5Stack firmware flashing?

Yes, the skill includes model-aware firmware provisioning with variant handling for Cardputer, Cardputer-Adv, Core, CoreS3, and Stick to prevent boot-loop mistakes caused by flashing the wrong image.

Why does my M5Stack boot-loop after flashing UIFlow 2.0 firmware?

An M5Stack may boot-loop after flashing UIFlow 2.0 firmware if the wrong variant image is applied, which this skill prevents by using model-aware variant handling and correct NVS boot_option configuration during the deployment process.