home-assistant-awtrix

Savant verdict: Review advised

Security analysis or source-hub review identified patterns requiring attention.

Live evaluation

Not evaluated yet. Workspaces can request a live evaluation.

Security assessment

Scan pending.

Structure

• Ships 1 executable scriptscripts/awtrix_fs.py. Review what they do before enabling the skill for agents with tool access.
• No license declaredConfirm you may reuse this skill before importing it into your repository.
• The source hub's security checks flagged this skillGen Agent Trust Hub: warn (The skill manages AWTRIX devices via HTTP and includes functionality to dynamically install Python dependencies (Pillow) at runtime. It also suggests shell command patterns for bulk file operations that are potentially vulnerable to indirect prompt injection if device filenames are malicious.); Runlayer: warn (5/5 files flagged)

SKILL.md

---
name: home-assistant-awtrix
description: Manage AWTRIX 3 devices via HTTP filesystem and utility endpoints. Use when listing/uploading/renaming/deleting files, checking flash usage, configuring Wi-Fi, controlling LiveView, or importing LaMetric icons.
---

# AWTRIX

## Workflow

- Use the bundled `awtrix_fs.py` script for deterministic filesystem operations and LaMetric icon imports.
- Use absolute device paths (leading `/`) to avoid firmware path errors.
- Use references for endpoint behavior and MQTT/HA integration patterns.

## Quick start

All script and reference files are relative to the location of this SKILL.md file.

```bash
python3 scripts/awtrix_fs.py --host <ip> status
python3 scripts/awtrix_fs.py --host <ip> icons list
python3 scripts/awtrix_fs.py --host <ip> icons import-lametric <id>
```

## Tasks

### Import a LaMetric icon by ID

- Run: `python3 scripts/awtrix_fs.py --host <ip> icons import-lametric <id>`
- Read: `references/AWTRIX_HTTP_FILESYSTEM.md` for endpoint details

### List icons on the device

- Run: `python3 ~/.codex/skills/home-assistant-awtrix/scripts/awtrix_fs.py --host <ip> icons list`

### Upload / rename / delete files

- Upload local file: `... upload ./local.jpg /ICONS/9999.jpg`
- Rename: `... rename /ICONS/old.gif /ICONS/new.gif`
- Delete: `... delete /ICONS/bad.gif`

### Delete ALL icons safely (avoid 404 loop bug)

When deleting many files returned by `icons list`, avoid command substitution loops that collapse whitespace. Use a line-safe loop so each filename is deleted individually:

```bash
python3 scripts/awtrix_fs.py --host <ip> icons list \
  | awk '{print $3}' \
  | while IFS= read -r f; do
      python3 scripts/awtrix_fs.py --host <ip> delete "/ICONS/$f"
    done
```

## References

- HTTP endpoints, filesystem API, and LaMetric import details: `references/AWTRIX_HTTP_FILESYSTEM.md`
- MQTT/HA control patterns (custom apps, notify, settings): `references/AWTRIX.md`
- Upstream MQTT API reference: `references/upstream-api.md`