← Back to Skills Marketplace
newageinvestments25-byte

Homelab Assets

by New Age Investments · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ✓ Security Clean
114
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install homelab-assets
Description
Track and manage homelab hardware inventory with details on purchase, warranty, power use, location, spend, and generate insurance-ready reports.
README (SKILL.md)

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/\x3Cscript>.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 \x3Cuuid> --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 \x3Cdays>. 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.

Usage Guidance
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.
Capability Analysis
Type: OpenClaw Skill Name: homelab-assets Version: 1.0.0 The homelab-assets skill bundle is a well-structured tool for managing a local hardware inventory. All scripts (add_asset.py, inventory.py, report.py, search.py, update_asset.py) use the Python standard library to perform CRUD operations on a local JSON file located in the user's workspace. There is no evidence of network activity, shell execution, sensitive data exfiltration, or malicious prompt injection.
Capability Assessment
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.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install homelab-assets
  3. After installation, invoke the skill by name or use /homelab-assets
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of homelab-assets. - Track and manage homelab hardware inventory, including servers, switches, UPS units, drives, cables, and accessories. - Records key asset details: purchase info, warranty dates, power draw, and physical location. - Answer questions about inventory, homelab spend, upcoming warranty expirations, and estimated power costs. - Generate insurance-ready asset reports and detailed Markdown summaries. - Includes scripts for adding, updating, searching, listing, and reporting on hardware assets using a local JSON file.
Metadata
Slug homelab-assets
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Homelab Assets?

Track and manage homelab hardware inventory with details on purchase, warranty, power use, location, spend, and generate insurance-ready reports. It is an AI Agent Skill for Claude Code / OpenClaw, with 114 downloads so far.

How do I install Homelab Assets?

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

Is Homelab Assets free?

Yes, Homelab Assets is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Homelab Assets support?

Homelab Assets is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Homelab Assets?

It is built and maintained by New Age Investments (@newageinvestments25-byte); the current version is v1.0.0.

💬 Comments