light_switch

Control board lights and GPIO indicators via Lua scripts.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

It removes the need for manual pin/LED configuration by letting users control board lights through simple natural-language requests.

Core Features & Use Cases

  • Board light control: Turn a board light on/off, set LED strip color, and adjust LED brightness.
  • GPIO light control: Toggle GPIO-based indicator lights using active-level logic and brightness-as-on/off behavior.
  • Hardware-safe execution: Operates only after reading board_hardware_info and uses declared occupied IO lines instead of guessing pins.

Quick Start

Ask your agent: "Turn on the board light to a warm red at 50% brightness."

Frequently Asked Questions about light_switch

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

FAQPage Schema
How do I control GPIO lights and LED strips on an IoT board?

You can control GPIO lights and LED strips by issuing natural-language requests to your agent. The Skill translates these requests into a validated Lua script that toggles GPIO indicator states and sets LED strip color and brightness.

Can I adjust LED strip brightness and color through a conversation interface?

Yes, you can adjust LED strip brightness and color conversationally. The Skill processes your request, validates the arguments, and executes a Lua script on the board to set the exact color and brightness level you specify.

Do I need to manually configure pins to toggle board-mounted lighting?

No, you do not need to manually configure pins. The Skill reads board hardware info to identify declared occupied IO lines and safely executes the lighting command without guessing pins.

How does active-level logic work for GPIO indicator lights?

Active-level logic for GPIO indicator lights is handled by the Skill by toggling the GPIO state and applying brightness-as-on/off behavior. It executes this via a Lua script after validating your hardware info.

What happens if the Lua script fails when setting board lights?

If the Lua script fails when setting board lights, the Skill returns the lua_run_script error directly to you. This ensures you receive immediate feedback on why the lighting control execution failed.