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

触发场景

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

安装

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

更多选项

非标准路径

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

不安装直接使用

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"
        ]
    },
    "description": "Take one photo with the first available video camera and save it as a JPEG file."
}

Take Picture

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

Run exactly one script with lua_run_script.

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.