AgentSkillsCN

control-office-lamp

通过 Home Assistant 控制办公室灯。当用户要求打开、关闭或切换办公室灯，或查询其状态时，请使用此功能。触发词包括“打开我的灯”、“办公室灯开/关”、“切换灯”或“我的灯开着吗”。

SKILL.md
--- frontmatter
name: control-office-lamp
description: Control office lamp via Home Assistant. Use when the user asks to turn on, turn off, or toggle their office lamp, or check its status. Triggers on phrases like "turn on my lamp", "office light on/off", "toggle the lamp", or "is my lamp on".
allowed-tools:
  - Bash
  - Read

Home Assistant Office Lamp Control

Control the office lamp through Home Assistant's REST API.

Setup (First-Time Only)

Create your config file at ~/.claude/skill-config/control-office-lamp/config.json:

json
{
  "url": "http://your-home-assistant:8123",
  "token": "YOUR_LONG_LIVED_ACCESS_TOKEN_HERE",
  "entity_id": "light.office_lamp"
}

This location persists across skill updates.

To create a Long-Lived Access Token:

  1. •Open Home Assistant -> Profile (bottom-left)
  2. •Scroll to "Long-Lived Access Tokens" -> Create Token
  3. •Copy the token into config.json

Config lookup order:

  1. •HA_CONFIG_PATH environment variable
  2. •~/.claude/skill-config/control-office-lamp/config.json (recommended)
  3. •${CLAUDE_PLUGIN_ROOT}/skills/control-office-lamp/config.json (plugin root)
  4. •<script-directory>/../config.json (fallback)

Usage

The script is located relative to the plugin root using ${CLAUDE_PLUGIN_ROOT}:

bash
# Turn lamp on
uv run "${CLAUDE_PLUGIN_ROOT}/skills/control-office-lamp/scripts/lamp_control.py" on

# Turn lamp off
uv run "${CLAUDE_PLUGIN_ROOT}/skills/control-office-lamp/scripts/lamp_control.py" off

# Toggle lamp state
uv run "${CLAUDE_PLUGIN_ROOT}/skills/control-office-lamp/scripts/lamp_control.py" toggle

# Check current status
uv run "${CLAUDE_PLUGIN_ROOT}/skills/control-office-lamp/scripts/lamp_control.py" status

Response Handling

Success response:

json
{"success": true, "action": "turn_on", "entity_id": "light.office_lamp", "response": [...]}

Error response:

json
{"success": false, "error": "Connection failed: ..."}

If errors occur, verify:

  1. •Home Assistant is running at the configured URL
  2. •The token is valid and not expired
  3. •The entity_id exists in Home Assistant