Agent Skills › espressif/esp-claw › take_picture

take_picture

GitHub

调用板载摄像头拍摄单张照片并保存为JPEG文件。需先确认硬件信息，执行Lua脚本完成捕获，支持自定义文件名、目录及超时参数，直接返回结果或错误。

components/lua_modules/lua_module_camera/skills/take_picture/SKILL.md espressif/esp-claw

Trigger Scenarios

用户要求拍照或截取图片需要保存摄像头静态画面

Install

npx skills add espressif/esp-claw --skill take_picture -g -y

More Options

Non-standard path

npx skills add https://github.com/espressif/esp-claw/tree/master/components/lua_modules/lua_module_camera/skills/take_picture -g -y

Use without installing

npx skills use espressif/esp-claw@take_picture

指定 Agent (Claude Code)

npx skills add espressif/esp-claw --skill take_picture -a claude-code -g -y

安装 repo 全部 skill

npx skills add espressif/esp-claw --all -g -y

预览 repo 内 skill

npx skills add espressif/esp-claw --list

SKILL.md

Frontmatter

{
    "name": "take_picture",
    "metadata": {
        "cap_groups": [
            "cap_lua"
        ],
        "manage_mode": "readonly"
    },
    "description": "Take one photo with the board camera and save it as a JPEG file. Requires board_hardware_info skill."
}

Take Picture

Use this skill when the user asks to take a photo, capture a picture, snap an image, or save a camera still from the board camera.

Run exactly one script with lua_run_script after reading board_hardware_info.

If lua_run_script returns an error, report that error directly to the user. Do not retry with changed arguments or run another camera script in the same turn unless the user explicitly asks.

Script Args Schema

{
  "type": "object",
  "properties": {
    "filename": {
      "type": "string",
      "default": "capture.jpg",
      "description": "JPEG filename to create under the storage root or under dir."
    },
    "dir": {
      "type": "string",
      "default": "",
      "description": "Optional single directory name under the storage root."
    },
    "timeout_ms": {
      "type": "integer",
      "default": 3000,
      "minimum": 0
    },
    "skip_frames": {
      "type": "integer",
      "default": 3,
      "minimum": 0,
      "description": "Number of warm-up frames to discard before saving the photo."
    }
  }
}

Path rules:

filename must be a simple .jpg or .jpeg filename.
filename must not contain /, \, or ...
dir is optional and must be a single directory name under the storage root.
dir must not contain /, \, or ...

Tool Call Inputs

Take a photo with the default output name:

{"path":"{CUR_SKILL_DIR}/scripts/take_picture.lua","args":{}}

Take a photo with a custom filename:

{"path":"{CUR_SKILL_DIR}/scripts/take_picture.lua","args":{"filename":"photo.jpg"}}

Take a photo into a storage-root-relative directory:

{"path":"{CUR_SKILL_DIR}/scripts/take_picture.lua","args":{"dir":"photos","filename":"latest.jpg","timeout_ms":5000}}

Take a photo after discarding more warm-up frames:

{"path":"{CUR_SKILL_DIR}/scripts/take_picture.lua","args":{"filename":"stable.jpg","skip_frames":5}}

Recommended Flow

Activate the board_hardware_info skill and confirm that a camera device is listed.
If no camera is listed, tell the user that the board does not declare a camera and stop.
Choose a safe filename. Use the default unless the user requested a specific output name.
Run {CUR_SKILL_DIR}/scripts/take_picture.lua with the selected args.
Report the saved path, byte count, resolution, pixel format, skipped warm-up frames, and any error directly from the script output.