hardware-assessment

Cross-platform hardware assessment and system maintenance — assess hardware, update OS/tools/custom software, and track changes over time via JSON changelogs

5 stars

byvamseeachanta

View on GitHub Installation ↓

Best use case

hardware-assessment is best used when you need a repeatable AI agent workflow instead of a one-off prompt.

Cross-platform hardware assessment and system maintenance — assess hardware, update OS/tools/custom software, and track changes over time via JSON changelogs

Teams using hardware-assessment should expect a more consistent output, faster repeated execution, less prompt rewriting.

When to use this skill

You want a reusable workflow that can be run more than once with consistent structure.

When not to use this skill

You only need a quick one-off answer and do not need a reusable workflow.
You cannot install or maintain the underlying files, dependencies, or repository context.

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/hardware-assessment/SKILL.md --create-dirs "https://raw.githubusercontent.com/vamseeachanta/workspace-hub/main/.agents/skills/operations/devops/hardware-assessment/SKILL.md"

Manual Installation

Download SKILL.md from GitHub
Place it in .claude/skills/hardware-assessment/SKILL.md inside your project
Restart your AI agent — it will auto-discover the skill

How hardware-assessment Compares

Feature / Agent	hardware-assessment	Standard Approach
Platform Support	Not specified	Limited / Varies
Context Awareness	High	Baseline
Installation Complexity	Unknown	N/A

Frequently Asked Questions

What does this skill do?

Cross-platform hardware assessment and system maintenance — assess hardware, update OS/tools/custom software, and track changes over time via JSON changelogs

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

SKILL.md Source

# Hardware Assessment

## When to Use This Skill

### USE when:

- Inventorying machines for consolidation or repurposing decisions
- Comparing hardware specs across multiple devices
- Planning GPU, RAM, or storage upgrades
- Auditing SMART health status across storage devices
- Keeping machines updated (OS packages, tools, custom software)
- Tracking what changed after updates via changelogs
- Documenting system configurations for compliance or handoff
### DON'T USE when:

- You need real-time monitoring (use Prometheus/Grafana instead)
- You need benchmark/performance data (this collects specs, not performance)

## Quick Start

### Linux

```bash
# Copy script to target machine, then:
bash hardware-assess.sh -p

# With sudo for SMART data + RAM type:
sudo bash hardware-assess.sh -p

# Custom output path:
bash hardware-assess.sh -o /tmp/inventory.json --pretty
```
### Windows (PowerShell)

```powershell
# Run in PowerShell:
.\hardware-assess.ps1 -Pretty

# Custom output:
.\hardware-assess.ps1 -OutputFile C:\temp\inventory.json -Pretty
```
### Full Maintenance (assess + update + re-assess)

```bash
# Linux — runs all 4 phases, outputs to maintenance/ directory:
sudo bash system-maintain.sh -d ./maintenance

# With custom software config:
sudo bash system-maintain.sh -c ./custom-packages.json -d ./maintenance

# Assessment only (no updates):
bash system-maintain.sh --skip-update -d ./maintenance
```

*See sub-skills for full details.*
### Update Only (no assessment)

```bash
# Linux:
sudo bash system-update.sh -c ./custom-packages.json

# Windows:
.\system-update.ps1 -ConfigFile .\custom-packages.json
```
### Custom Software Config (JSON)

```json
{
  "packages": {
    "apt": ["openfoam", "freecad", "paraview", "smartmontools"],
    "snap": ["code"],
    "pip": ["numpy", "polars"]
  },
  "ppas": ["ppa:openfoam/latest"],
  "scripts": [
    { "name": "custom-tool", "check": "custom-tool --version", "install": "curl -sSL https://example.com/install.sh | bash" }
  ]
}
```

## Version History

- **1.1.0** (2026-02-02): Add system-update and system-maintain orchestrator scripts for OS/tools/custom software updates with changelog tracking
- **1.0.0** (2026-02-02): Initial release — Linux Bash + Windows PowerShell scripts with unified JSON schema

## Sub-Skills

- [Troubleshooting](troubleshooting/SKILL.md)

## Sub-Skills

- [Scripts](scripts/SKILL.md)
- [Linux (`hardware-assess.sh`) (+1)](linux-hardware-assesssh/SKILL.md)
- [Output Schema (v1.0)](output-schema-v10/SKILL.md)
- [Linux (+1)](linux/SKILL.md)
- [Workflow: Multi-Machine Inventory](workflow-multi-machine-inventory/SKILL.md)

Related Skills

ai-tool-assessment

from vamseeachanta/workspace-hub

Assess and report on AI tool subscriptions, usage patterns, and cost-effectiveness. Use for reviewing AI subscriptions, analyzing tool usage, optimizing AI spend.

risk-assessment

from vamseeachanta/workspace-hub

Perform probabilistic risk assessment with Monte Carlo simulations for offshore marine operations

multi-tool-architecture-assessment

from vamseeachanta/workspace-hub

Systematic comparison of competing tools/approaches before committing to a multi-account, multi-tool architecture. Uses parallel subagents for research, system-state audit, and data quality analysis. Produces a decision matrix with explicit trade-offs.