lua_demo

Run bundled Lua applications as interactive on-device programs for IoT edge hardware.

2.0k|410|Updated Apr 17, 2026
One-click install
npx skills add https://github.com/espressif/esp-claw --skill lua-demo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: lua_demo
Source: https://github.com/espressif/esp-claw/tree/main/application/edge_agent/fatfs_image/skills/lua_demo
Command: npx skills add https://github.com/espressif/esp-claw --skill lua-demo

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill lets users immediately run ready-made interactive Lua applications—like games, visualizers, and live previews—on their device without writing new code.

Core Features & Use Cases

  • Run Lua demo apps from a curated set: Launches one bundled Lua application per request, such as Flappy Bird, an audio FFT visualizer, or camera preview.
  • Hardware-aware execution: Uses hardware requirements (e.g., display, touch, audio input, camera) and refuses to run when required hardware is missing.
  • Deterministic single-script control: Executes exactly one script via the provided tool and returns any Lua runtime error directly to the user.

Quick Start

Ask the assistant to run a specific demo, for example: "Run the Flappy Bird game on my device."

Frequently Asked Questions about lua_demo

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

FAQPage Schema
How do I run a Lua demo app on IoT edge hardware?

To run a Lua demo on IoT edge hardware, request a specific bundled application like Flappy Bird or an audio FFT visualizer. The system executes exactly one script via lua_run_script and launches the interactive program directly on your device.

What interactive Lua applications can I run on an edge computing board?

You can run interactive Lua applications such as Flappy Bird for display-based games, touch drawing apps, audio FFT visualizers, and camera preview demos. These ready-made programs execute directly on compatible IoT edge devices without writing new code.

Do I need specific hardware to run Lua interactive demos on my device?

Yes, Lua interactive demos require specific hardware validated via board_hardware_info. Display, touch, audio input, or camera capabilities are needed depending on the demo. The system checks requirements and refuses to run when required hardware is missing.

What happens when a Lua script fails to execute on my board?

When a Lua script fails to execute on your board, the system returns the lua_run_script error directly to you without retrying. This deterministic single-script control ensures you receive the exact runtime error for immediate troubleshooting.

Can I run multiple Lua scripts simultaneously on edge computing hardware?

No, you cannot run multiple Lua scripts simultaneously. The system enforces deterministic single-script control by executing exactly one script per request through lua_run_script, ensuring isolated and predictable performance for your IoT edge hardware.

Why does my camera preview Lua demo refuse to launch on edge hardware?

Your camera preview Lua demo refuses to launch because the system validates required hardware via board_hardware_info before execution. If your edge hardware lacks the necessary camera component, the demo will not run to prevent runtime errors.