Description

Personal device and appliance manager with error code lookup and troubleshooting. Tracks all your devices (appliances, electronics, software) with model numbers, manuals, and warranty info. When something breaks, tell it the error code and get instant solutions. Use when: device shows error, need manual, warranty check, adding new device, maintenance reminder. Triggers: /device, /geräte, 'mein Geschirrspüler', 'Fehler E24', 'Fehlermeldung', device problems, appliance issues.

README (SKILL.md)

Device Assistant 🔧

Name: Device Assistant
Author: udiedrichsen

Personal device manager with error code lookup, troubleshooting, and maintenance tracking.

Features

Device Registry: Track all devices with model, serial, purchase info
Error Lookup: Instant error code explanations
Troubleshooting: Step-by-step solutions
Manual Links: Quick access to documentation
Warranty Tracking: Know when warranties expire
Maintenance Reminders: Filter changes, updates, etc.

Commands

Command	Action
`/device`	List all devices or show status
`/device add`	Add a new device (interactive)
`/device list [category]`	List devices by category
`/device info \x3Cname>`	Show device details
`/device error \x3Cname> \x3Ccode>`	Lookup error code
`/device help \x3Cname> \x3Cproblem>`	Troubleshoot a problem
`/device manual \x3Cname>`	Get manual/documentation
`/device warranty`	Show warranty status
`/device maintenance`	Show maintenance schedule
`/device remove \x3Cname>`	Remove a device

Natural Language

The skill understands natural queries:

"Mein Geschirrspüler zeigt E24"
"Waschmaschine macht komische Geräusche"
"Wo ist die Anleitung für den Thermomix?"
"Wann läuft die Garantie vom TV aus?"

Device Categories

Category	Examples
`kitchen`	Geschirrspüler, Kühlschrank, Backofen, Thermomix
`laundry`	Waschmaschine, Trockner
`electronics`	TV, Router, NAS, Computer
`climate`	Heizung, Klimaanlage, Luftreiniger
`smart-home`	Hue, Homematic, Sensoren
`software`	Apps, Betriebssysteme, Lizenzen
`other`	Alles andere

Handler Commands

handler.sh status $WORKSPACE                     # Overview
handler.sh list [category] $WORKSPACE            # List devices
handler.sh add \x3Cjson> $WORKSPACE                 # Add device
handler.sh info \x3Cdevice-id> $WORKSPACE           # Device details
handler.sh error \x3Cdevice-id> \x3Ccode> $WORKSPACE   # Error lookup
handler.sh troubleshoot \x3Cdevice-id> \x3Cproblem> $WS # Get help
handler.sh manual \x3Cdevice-id> $WORKSPACE         # Manual link
handler.sh warranty $WORKSPACE                   # Warranty overview
handler.sh maintenance $WORKSPACE                # Maintenance due
handler.sh update \x3Cdevice-id> \x3Cjson> $WORKSPACE  # Update device
handler.sh remove \x3Cdevice-id> $WORKSPACE         # Remove device
handler.sh search \x3Cquery> $WORKSPACE             # Search devices
handler.sh log \x3Cdevice-id> \x3Cnote> $WORKSPACE     # Add maintenance log

Data Structure

Device Entry

{
  "id": "dishwasher-1",
  "name": "Geschirrspüler",
  "nickname": "Spüli",
  "category": "kitchen",
  "manufacturer": "Siemens",
  "model": "SN658X06TE",
  "serialNumber": "ABC123456",
  "purchaseDate": "2022-03-15",
  "purchasePrice": 899,
  "warranty": {
    "expires": "2025-03-15",
    "type": "manufacturer",
    "notes": "3 Jahre Siemens"
  },
  "manualUrl": "https://...",
  "supportUrl": "https://...",
  "location": "Küche",
  "notes": "Salz alle 2 Monate nachfüllen",
  "maintenance": [
    {"task": "Filter reinigen", "interval": "monthly", "lastDone": "2026-01-01"}
  ],
  "errorHistory": [],
  "addedAt": "2024-01-01"
}

Error Code Lookup

The skill searches for error codes using:

Built-in database for common manufacturers
Web search for specific model + error code
Manual extraction if manual URL is stored

Common Error Code Patterns

Manufacturer	Pattern	Example
Siemens/Bosch	E + number	E24, E15
Miele	F + number	F11, F53
AEG	E + number	E10, E20
Samsung	Letters + numbers	UE, OE, LE
LG	Letters	OE, IE, PE

Example Session

User: Ich habe einen neuen Geschirrspüler

Bot: 🔧 Neues Gerät hinzufügen:
     
     Welche Infos hast du?
     • Hersteller?
     • Modell?
     • Seriennummer? (optional)
     • Kaufdatum?

User: Siemens SN658X06TE, gekauft am 15.3.2022

Bot: ✅ Gespeichert!
     
     📦 Geschirrspüler (Siemens SN658X06TE)
     📅 Gekauft: 15.03.2022
     🛡️ Garantie: bis 15.03.2025 (ABGELAUFEN)
     📄 Anleitung: [Link gefunden]
     
     Spitzname vergeben? (z.B. "Spüli")

User: Mein Geschirrspüler zeigt E24

Bot: 🔧 Siemens SN658X06TE — Fehler E24
     
     ⚠️ Bedeutung: Abpumpproblem
     Das Wasser wird nicht richtig abgepumpt.
     
     🔨 Lösung:
     1. Gerät ausschalten
     2. Sieb am Boden prüfen und reinigen
     3. Abflussschlauch auf Knicke prüfen
     4. Siphon-Anschluss kontrollieren
     5. Gerät neu starten
     
     📄 Details: Anleitung S. 45
     
     [Problem gelöst] [Weitere Hilfe]

Data Files

Stored in $WORKSPACE/memory/device-assistant/:

File	Purpose
`devices.json`	All registered devices
`error-history.json`	Past errors and solutions
`maintenance-log.json`	Maintenance history
`error-codes/`	Cached error code info

Warranty Alerts

The skill can remind you before warranties expire:

⚠️ Garantie-Warnung:

Diese Geräte laufen bald ab:
• TV Samsung (noch 30 Tage)
• Waschmaschine (noch 45 Tage)

Tipp: Jetzt prüfen ob alles funktioniert!

Requirements

jq (JSON processing)
curl (web lookups)
Internet for error code search

Usage Guidance

This skill appears coherent with its description and stores data locally under $WORKSPACE/memory/device-assistant. Before installing, decide where you want the WORKSPACE to live (ensure it's a safe directory), and be aware that lookup/manual commands can fetch external URLs (the script builds Google search links and may call curl). Do not add manual/support URLs that contain sensitive tokens or credentials. If you need stricter privacy, run the handler in a restricted environment or inspect/disable network calls in scripts before use.

Capability Analysis

Type: OpenClaw Skill Name: device-assistant Version: 1.0.0 The OpenClaw AgentSkills skill bundle for 'device-assistant' is classified as benign. The `SKILL.md` clearly outlines the purpose of a device manager, requiring `jq` for JSON processing and `curl` for web lookups, which are justified by features like error code search. The core logic in `scripts/handler.sh` operates strictly within the designated `$WORKSPACE` for data storage and manipulation. While `curl` is listed as a requirement, the `handler.sh` script itself does not execute `curl` or make any outbound network requests; it only constructs Google search URLs which the AI agent might then use. There is no evidence of data exfiltration, malicious execution, persistence, prompt injection attempts, or obfuscation.

Capability Assessment

✓ Purpose & Capability

Name/description match the actual behavior: tracking devices in local JSON files, error-code lookup, manuals, warranty reminders. Required binaries (jq, curl) are reasonable for JSON manipulation and optional web lookups.

ℹ Instruction Scope

SKILL.md and handler.sh stay within the described scope (read/write JSON under $WORKSPACE/memory/device-assistant, lookup error codes, build search URLs). Note: the script constructs Google search URLs and may fetch external pages (curl) for manuals/searches — this is expected for error/manual lookup but means the skill may contact external websites when performing lookups or when following a user-provided manual/support URL.

✓ Install Mechanism

No install specification — instruction-only with a bundled shell handler. No remote installers or archive downloads; nothing is fetched during install.

✓ Credentials

No environment variables, credentials, or config paths required. The script uses only the provided $WORKSPACE directory for data storage; this is proportionate to the described functionality.

✓ Persistence & Privilege

always:false and no special privileges requested. The skill stores data in its own workspace path and does not attempt to modify other skills or system-wide settings.

Version History

v1.0.0

Initial release: Device registry, error code lookup, warranty tracking, troubleshooting

Metadata

Slug device-assistant

Version 1.0.0

License —

All-time Installs 1

Active Installs 1

Total Versions 1

Frequently Asked Questions

What is Device Assistant?

Personal device and appliance manager with error code lookup and troubleshooting. Tracks all your devices (appliances, electronics, software) with model numbers, manuals, and warranty info. When something breaks, tell it the error code and get instant solutions. Use when: device shows error, need manual, warranty check, adding new device, maintenance reminder. Triggers: /device, /geräte, 'mein Geschirrspüler', 'Fehler E24', 'Fehlermeldung', device problems, appliance issues. It is an AI Agent Skill for Claude Code / OpenClaw, with 2046 downloads so far.

How do I install Device Assistant?

Run "/install device-assistant" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Device Assistant free?

Yes, Device Assistant is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Device Assistant support?

Device Assistant is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Device Assistant?

It is built and maintained by udiedrichsen (@udiedrichsen); the current version is v1.0.0.

More Skills

Device Assistant