agentleFS
espressifespressif/esp-claw-skills-lab/skills/servo_dog/SKILL.md

servo_dog

Skill37 starsChanged 33 days agoMITView on GitHub

Use this skill when the user asks to control a four-servo robotic dog, start the Servo Dog web control panel, calibrate dog leg servo offsets, or run dog actions such as forward, backward, turn, bow, shake hand, jump, or retract legs. This skill controls four servos directly from Lua with mcpwm. Default GPIOs are: Default neutral angles are compatible with the original servo dog controller: 使用 lua_run_script_async 启动服务器。只有用户明确要求替换同名任务时才使用 replace: true。 It starts the PWM worker, mounts the bundled web UI,…

The file

We split this skill into the rules it gives an agent

8 rules. About 0 are common, 5 are distinctive, and 3 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈5

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 3

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Use this skill when the user asks to control a four-servo robotic dog, start the Servo Dog web control panel, calibrate dog leg servo …

    line 17
  2. Distinctive:

    Default neutral angles are compatible with the original servo dog controller:

    line 26
  3. Distinctive:

    After it starts, open:

    line 59
  4. Distinctive:

    If the command script reports that the controller is not running, start the web control script first.

    line 87
  5. Distinctive:

    Start calibration from the web UI or send:

    line 163
  6. Very specific:

    Add a Lua function that calls set_angle() or set_angles() and uses action_delay(ms) inside long loops.

    line 189
  7. Very specific:

    Add a button entry in the server ACTIONS list if the web UI should expose it.

    line 192
  8. Very specific:

    Use action_delay() instead of delay.delay_ms() inside actions so a new command can interrupt the current action.

    line 194

≈ “Common” is an estimate: at least 1 in 5 of the 364,980 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Servo Dog

Use this skill when the user asks to control a four-servo robotic dog, start the Servo Dog web control panel, calibrate dog leg servo offsets, or run dog actions such as forward, backward, turn, bow, shake hand, jump, or retract legs.

This skill controls four servos directly from Lua with mcpwm. Default GPIOs are:

  • fl_gpio: 1
  • fr_gpio: 2
  • bl_gpio: 41
  • br_gpio: 42

Default neutral angles are compatible with the original servo dog controller:

  • fl_neutral: 70
  • fr_neutral: 110
  • bl_neutral: 110
  • br_neutral: 70

Start Web Control

使用 lua_run_script_async 启动服务器。只有用户明确要求替换同名任务时才使用 replace: true。 It starts the PWM worker, mounts the bundled web UI, and registers HTTP APIs.

{
  "path": "{CUR_SKILL_DIR}/scripts/servo_dog_server.lua",
  "timeout_ms": 0,
  "name": "servo_dog_server",
  "exclusive": "servo_dog",
  "replace": false,
  "args": {
    "app_id": "servo_dog",
    "queue_name": "servo_dog_cmd",
    "web_root": "{CUR_SKILL_DIR}/assets",
    "worker_path": "{CUR_SKILL_DIR}/scripts/servo_dog_worker.lua",
    "worker_args": {
      "fl_gpio": 1,
      "fr_gpio": 2,
      "bl_gpio": 41,
      "br_gpio": 42
    }
  }
}

After it starts, open:

/lua/servo_dog/

The page uses:

  • GET /api/lua/servo_dog/state
  • POST /api/lua/servo_dog/control
  • GET /api/lua/servo_dog/start_calibration
  • GET /api/lua/servo_dog/exit_calibration
  • POST /api/lua/servo_dog/adjust

Command Control

For command or agent control, keep the server running and call:

{
  "path": "{CUR_SKILL_DIR}/scripts/servo_dog_command.lua",
  "args": {
    "queue_name": "servo_dog_cmd",
    "action": "forward"
  }
}

If the command script reports that the controller is not running, start the web control script first.

Actions

Supported action names:

  • installation
  • idle
  • forward
  • backward
  • turn_left
  • turn_right
  • lay_down
  • bow
  • lean_back
  • bow_lean
  • sway_back_forth
  • sway
  • shake_hand
  • poke
  • shake_back_legs
  • jump_forward
  • jump_backward
  • retract_legs

Movement aliases:

{"move":"F"}
{"move":"B"}
{"move":"L"}
{"move":"R"}

Original web action id aliases:

{"action":"1"}
{"action":"2"}
{"action":"3"}
{"action":"4"}
{"action":"5"}
{"action":"6"}
{"action":"7"}
{"action":"8"}
{"action":"9"}
{"action":"10"}
{"action":"11"}
{"action":"12"}

These map to lay_down, bow, lean_back, bow_lean, sway_back_forth, sway, shake_hand, poke, shake_back_legs, jump_forward, jump_backward, and retract_legs.

Optional Action Args

Some actions accept overrides:

{
  "action": "forward",
  "args": {
    "repeat_count": 3,
    "speed": 90
  }
}

Supported fields are:

  • repeat_count: positive integer for repeated gait/action cycles.
  • speed: higher values shorten interpolation delay.
  • hold_time_ms: hold duration for actions such as bow, lean_back, and shake_hand.
  • angle_offset: offset used by idle and sway.

Calibration

Start calibration from the web UI or send:

{"action":"installation"}

Adjust one servo offset:

{
  "path": "{CUR_SKILL_DIR}/scripts/servo_dog_command.lua",
  "args": {
    "queue_name": "servo_dog_cmd",
    "type": "adjust",
    "servo": "fl",
    "value": 3
  }
}

Valid servo ids are fl, fr, bl, and br. Values are clamped to -25..25 and saved under the DATA root in servo_dog/config.json.

Extension

扩展动作时,在源码包中修改对应的 {CUR_SKILL_DIR}/scripts/servo_dog_worker.lua 后重新部署;不要直接修改 SYSTEM 中的只读包。若用户要求设备端修改,应先创建 DATA 中的完整同名包覆盖,再通过 publish_skill 发布。

  1. Add a Lua function that calls set_angle() or set_angles() and uses action_delay(ms) inside long loops.
  2. Register it in the actions table.
  3. Optionally add an alias in action_aliases.
  4. Add a button entry in the server ACTIONS list if the web UI should expose it.

Use action_delay() instead of delay.delay_ms() inside actions so a new command can interrupt the current action.

包路径与退出

默认网页资源和 worker 路径从当前脚本位置解析,兼容 SYSTEM 与 DATA 安装。校准数据仍保存在 DATA 根目录的 servo_dog/config.json。服务器只清理本次创建的 worker 和命令队列,遇到已有任务或队列冲突时报告错误,不自动停止别的任务。

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.