Homelab Assets

Track and manage homelab hardware inventory with details on purchase, warranty, power use, location, spend, and generate insurance-ready reports.

Security Scan

The skill is internally consistent with its stated purpose: local management of a JSON homelab inventory using included Python scripts, with no network calls or unrelated credential requests.

Purpose & Capability

Name/description match the code and instructions. All required capabilities (reading/writing a local JSON inventory, generating reports, searching/updating assets) are appropriate for an inventory/asset-tracking skill; no extraneous credentials, binaries, or unrelated capabilities are requested.

Instruction Scope

SKILL.md explicitly confines data to a single inventory JSON (default ~/.openclaw/workspace/homelab-assets/inventory.json, overridable by HOMELAB_ASSETS_PATH) and instructs running the bundled Python scripts. The runtime instructions do not request other system files, network endpoints, or broad contextual data beyond the inventory file.

Install Mechanism

No install spec or external downloads are present. All functionality is provided by the bundled, human-readable Python scripts — nothing will be fetched from the network during install.

Credentials

No secrets or credentials are required. The only environment access is optionally reading HOMELAB_ASSETS_PATH to override the inventory file path, which is reasonable for this purpose.

Persistence & Privilege

The skill is not force-enabled (always:false) and requests no system-wide privileges. It reads and writes a single inventory file under the user's home directory; this is expected for an asset-tracking tool.

Assessment

This skill appears to do what it says: it stores and manages a local JSON inventory using the included Python scripts and does not contact external services or request secrets. Before installing: (1) confirm you are comfortable with the inventory file being created at ~/.openclaw/workspace/homelab-assets/inventory.json (or set HOMELAB_ASSETS_PATH to a different location), (2) back up any existing inventory.json if you have one, (3) verify file permissions on the inventory file to keep sensitive serial numbers/locations private, and (4) ensure python3 is available in the execution environment. If you want extra caution, inspect the included scripts locally (they are plain Python) and run them manually rather than allowing autonomous agent invocation.

Homelab Assets Skill

Manages a local JSON inventory of homelab hardware. All data lives at ~/.openclaw/workspace/homelab-assets/inventory.json.

Scripts

All scripts live in scripts/. Run with python3 scripts/<script>.py [args]. Use --help on any script for full usage.

add_asset.py — Add a hardware asset

python3 scripts/add_asset.py \
  --name "Raspberry Pi 4" \
  --type server \
  --brand Raspberry Pi Foundation \
  --model "Pi 4 Model B 8GB" \
  --purchase-date 2023-06-15 \
  --purchase-price 85.00 \
  --warranty-months 12 \
  --power-watts 8 \
  --location "Rack Shelf 2" \
  --serial ABC123 \
  --notes "Runs Home Assistant"

Required: --name, --type. All others optional. UUID auto-generated. Types: server, switch, router, ups, drive, cable, accessory, other

update_asset.py — Update an existing asset

python3 scripts/update_asset.py --id <uuid> --status retired --location "Storage Box A"
python3 scripts/update_asset.py --search "Pi 4" --notes "Repurposed as DNS server" --power-watts 6

Target by --id (exact UUID) or --search (fuzzy name match). Updatable fields: --status, --location, --notes, --power-watts. Statuses: active, retired, sold, rma

inventory.py — List assets

python3 scripts/inventory.py
python3 scripts/inventory.py --type server --status active
python3 scripts/inventory.py --location "Rack" --warranty-expiring 90
python3 scripts/inventory.py --output json

Filters: --type, --status, --location (substring), --warranty-expiring <days>. Output: table (default) or --output json.

report.py — Generate full asset report

python3 scripts/report.py
python3 scripts/report.py --kwh-rate 0.14 --output report.md

Produces Markdown with: total assets, total investment, estimated current value (straight-line depreciation over 5 years), total power draw, monthly power cost estimate, warranty alerts (expiring within 90 days), assets by type, assets by location. Configurable --kwh-rate (default: 0.12).

search.py — Fuzzy search across all fields

python3 scripts/search.py "raspberry"
python3 scripts/search.py "rack shelf" --output json

Searches name, brand, model, location, notes, serial, type. Case-insensitive substring match across all text fields.

Data Location

Default: ~/.openclaw/workspace/homelab-assets/inventory.json Override with env var: HOMELAB_ASSETS_PATH=/path/to/inventory.json

References

See references/power-estimates.md for common homelab device power draw estimates. See assets/inventory.example.json for example asset structure.