Filament Vault

Track 3D printing filament inventory locally. Add spools, log usage, check stock levels, and generate spending reports. Use when: filament, spool, 3d print i...

Security Scan

The skill is internally consistent: it implements a local filament-inventory tool that reads/writes a JSON file under ~/.openclaw/workspace/filament-vault, with no network calls, no credentials requested, and no surprising install steps.

Purpose & Capability

Name/description match the included scripts and assets. All requested functionality (add, update, list, search, report) is implemented by the bundled Python scripts and uses a local JSON datastore. No extraneous credentials, binaries, or unrelated capabilities are requested.

Instruction Scope

SKILL.md instructs running the included Python scripts against the local inventory file (~/.openclaw/workspace/filament-vault/inventory.json). The instructions and scripts only access that path and perform inventory operations; they do not read other system files, environment variables, or remote endpoints.

Install Mechanism

There is no install spec (instruction-only), and the package contains plain Python scripts. Nothing is downloaded or executed from external sources during install. The included files are readable and not obfuscated.

Credentials

The skill requires no environment variables, credentials, or config paths beyond its own data directory. That is proportional to a local inventory tracker. The scripts only create/read/write the specified inventory.json file.

Persistence & Privilege

The skill is not set to always:true and does not modify other skills or global agent settings. It stores data under its own workspace path; this is expected and limited in scope.

Assessment

This skill appears to be a straightforward local inventory manager. Before installing or running it: (1) be aware it stores inventory data (including costs, locations, and free-text notes) in plain JSON at ~/.openclaw/workspace/filament-vault/inventory.json — if that contains sensitive info, consider file permissions or encryption; (2) inspect the included scripts if you want to be extra safe (they are small, readable, and do not make network calls); (3) run them under a Python virtualenv if you prefer environment isolation; (4) if you do not want the agent to invoke the skill autonomously, you can disable model invocation for this skill in your agent settings (the skill itself does not request that privilege). Overall there are no red flags in the code or SKILL.md.

Local filament inventory tracker. All data stored in JSON at ~/.openclaw/workspace/filament-vault/inventory.json.

Scripts

All scripts live in scripts/. Run with python3 scripts/<script>.py [args].

Add a Spool

python3 scripts/add_spool.py --brand "Bambu" --material PLA --color "Matte Black" --weight 1000 --cost 19.99 --location "Shelf A"

Options: --brand, --material (PLA/PETG/ABS/TPU/Nylon/ASA/other), --color, --weight (grams, default 1000), --cost (USD), --location, --notes

Update / Use a Spool

python3 scripts/update_spool.py --search "matte black" --used 150
python3 scripts/update_spool.py --id <uuid> --finished --notes "Ran out mid-print"

Options: --id (UUID), --search (partial match), --used (grams consumed), --finished (mark empty), --notes

List Inventory

python3 scripts/inventory.py
python3 scripts/inventory.py --material PLA --low-stock
python3 scripts/inventory.py --json

Filters: --material, --color, --brand, --low-stock (under threshold, default 100g), --threshold <g>, --json

Generate Report

python3 scripts/report.py
python3 scripts/report.py --threshold 200

Shows: total spools, total weight, total value, by-material breakdown, low-stock alerts, monthly spending.

Search

python3 scripts/search.py "bambu"
python3 scripts/search.py "black petg" --json

Fuzzy search across all fields (brand, color, material, location, notes).

References

See references/materials.md for filament material properties and guidance.