get-available-resources

Get Available Resources

Build a conservative picture of resources available to the current process. Keep host inventory, process affinity, cgroup/container limits, scheduler allocation, and accelerator runtime usability separate.

Safety contract

Follow these rules:

• Run detection when the user requests it or a specific workload needs resource planning. Do not persist a fingerprint for every scientific task.
• Use stdout by default. Persist only when the user chooses an explicit generic local filename.
• Do not run stress tests, benchmarks, large allocations, write probes, device resets, driver installation, or clock/power changes.
• Do not dump the environment. Read only the named Slurm and accelerator variables implemented by the detector.
• Do not report hostnames, absolute paths, cgroup paths, job IDs, device UUIDs, PCI addresses, or raw visibility-variable values.
• Treat a missing observation as unknown. Never convert unknown to unlimited.
• Never infer that a visible host CPU, memory pool, or GPU is usable inside a scheduler allocation or container.

The bundled detector uses only fixed executable/argument tuples, no shell, short timeouts, bounded stdout/stderr, and partial-failure warnings.

Quick start

Run from this skill directory.

Ephemeral stdout snapshot

python scripts/detect_resources.py

The command emits only JSON to stdout. Redirect it only when ordinary shell permissions are acceptable.

Explicit private file

python scripts/detect_resources.py --output resource-snapshot.json

Explicit output is restricted to one .json filename in the current directory, uses private permissions, rejects symlinks and path traversal, and refuses overwrite unless --force is supplied.

Optional psutil enhancement

The standard-library detector works without installation. For broader cross-platform physical-core, affinity, available-memory, swap, and disk coverage:

uv pip install "psutil==7.2.2"