take_picture

Capture a JPEG image from a board camera via Lua script execution.

2.0k|410|Updated Apr 17, 2026
One-click install
npx skills add https://github.com/espressif/esp-claw --skill take-picture
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: take_picture
Source: https://github.com/espressif/esp-claw/tree/main/components/lua_modules/lua_module_camera/skills/take_picture
Command: npx skills add https://github.com/espressif/esp-claw --skill take-picture

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

It solves the problem of manually capturing photos by letting you command an IoT board camera to take a still image and save it as a ready-to-use JPEG file.

Core Features & Use Cases

  • One-shot photo capture to JPEG: Takes a single picture and writes it under the storage root for immediate use (e.g., reporting a condition or logging evidence).
  • Configurable output and warm-up: Lets you choose a safe filename and optional subdirectory, plus discard warm-up frames before saving for more consistent results.
  • Hardware-first safety check: Ensures the board hardware information includes a camera by requiring the board_hardware_info skill before execution.
  • Strict execution and error surfacing: Runs exactly one camera script for the turn and directly reports any script error without retrying.

Quick Start

Ask: "Take a photo and save it as capture.jpg."

Frequently Asked Questions about take_picture

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

FAQPage Schema
How do I capture a JPEG image from an IoT board camera on demand?

You can capture a single image from an IoT board camera by running a Lua script that snaps a photo, discards warm-up frames, and saves the result as a JPEG file under a configurable output path.

Do I need to validate board hardware info before taking a picture with an edge device?

Yes, validating board hardware info is required. The workflow checks for a declared camera device via board_hardware_info validation before running the take_picture.lua script to prevent execution errors.

Can I discard camera warm-up frames before saving a JPEG file on my IoT device?

Yes, you can discard camera warm-up frames before saving the JPEG file. The capture process supports configurable warm-up settings to discard initial frames, ensuring more consistent image results for your IoT scenario.

What happens if the Lua camera capture script fails on my IoT board?

If the Lua camera capture script fails, the system directly returns the script error to you without attempting any retries. It runs exactly one camera script per turn for strict error surfacing.

How do I specify a custom filename and subdirectory when capturing a board camera photo?

You specify a custom filename and optional subdirectory by configuring the output path parameters before execution, allowing you to safely save the JPEG file exactly where needed under the storage root.

Is there a way to automate taking a single photo for IoT status reporting?

Yes, you can automate taking a single photo for IoT status reporting by issuing a command that runs the capture script exactly once. It snaps a single picture and writes a JPEG file for logging current device conditions.