machine-health
Skill1 starsChanged 3 days agoMITView on GitHub
Read-only health and configuration check of one Linux, macOS or Windows computer, writing a baseline into MACHINE.md on the first run and reporting drift on later runs: CPU, RAM, disks, errors, PATH, updates and devices. Use when the user says "check the health of this machine", "what drifted since last time" or "is this disk dying". Not for fixing a finding on Arch, use `arch-linux`.
1 other project uses a version of this.
Adopted by
Most recently taken up by
- ztrange/claude-skillstheir own version, first seen Nov 8, 2026
Other versions1 project uses a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 1
- ztrange/claude-skills★ 0same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository71 other files it gives its agents.
- AGENTS.mdAGENTS.md
- agentic-engineeringSkill
- ai-regression-testingSkill
- angularSkill
- ansibleSkill
- api-designSkill
- application-security-reviewSkill
- architecture-decision-recordsSkill
- arch-linuxSkill
- ascend-memorySkill
- ascend-web-hunterSkill
- asus-routerSkill
- audio-scribeSkill
- automation-inventorySkill
- backend-patternsSkill
- bashSkill
- build-dependency-managementSkill
- cachyosSkill
- code-formatterSkill
- code-reviewerSkill
- coding-standardsSkill
- dart-flutter-patternsSkill
- database-migrationsSkill
- deployment-patternsSkill
- design-systemSkill
- docker-patternsSkill
- e2e-runbooksSkill
- e2e-testingSkill
- embedded-c-arduinoSkill
- frontend-designSkill
- g-code-3d-printingSkill
- github-opsSkill
- git-workflowSkill
- golang-patternsSkill
- hexagonal-architectureSkill
- home-assistantSkill
- homelab-servicesSkill
- java-coding-standardsSkill
- jetbrains-ide-opsSkill
- jira-integrationSkill
- kde-plasmaSkill
- keycloak-patternsSkill
- kicadSkill
- macosSkill
- markdown-writerSkill
- mongodb-patternsSkill
- nextjs-app-router-patternsSkill
- node-backend-patternsSkill
- observability-and-loggingSkill
- obsidianSkill
- performance-optimizationSkill
- postgres-patternsSkill
- powershellSkill
- project-trackingSkill
- proxmoxSkill
- python-patternsSkill
- pytorch-patternsSkill
- quality-loopSkill
- react-patternsSkill
- researchSkill
- The first 60 shown.
The file
We split this skill into the rules it gives an agent
9 rules. About 0 are common, 4 are distinctive, and 5 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈4
Distinctive · estimate
This author's own choices. Worth a look.
5
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 52
Read MACHINE.md first: the never-touch table, the owner rows, Known quirks and the last Health entry.
- Very specific: line 53
Read-only. No install, no service change, no mount, no repair tool, no fsck, chkdsk /f, ntfsfix, btrfs check --repair, no cache cleaning …
- Very specific: line 54
Never run sudo, doas, pkexec, runas, an elevated PowerShell or anything that asks for a password.
- Distinctive: line 56
Every value carries the command it came from and the date from the system clock.
- Distinctive: line 60
No secret in the report: no key, passphrase, token, serial number or environment variable value.
- Very specific: line 61
Add a dated change log entry to MACHINE.md for every run, saying the run changed nothing on the system.
- Very specific: line 67
Read MACHINE.md and note the OS, the never-touch devices and the date of the last Health entry.
- Distinctive: line 68
Run the checks in the order of the table above, OS by OS, using only the commands marked for that OS.
- Distinctive: line 70
Write the baseline or the drift entry, update Needs root, add the change log entry.
≈ “Common” is an estimate: at least 1 in 5 of the 364,980 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Machine Health
A read-only health and configuration check for one computer, run after setup and again whenever the owner asks. The first run writes a dated baseline into the Health section of MACHINE.md. Every later run compares against that baseline and reports drift. The agent reports, fixes nothing on its own, never elevates, and hands every root command and every fix to the owner.
Linux commands were executed read-only on one CachyOS host with systemd and Plasma 6, and each one that ran says so. macOS and Windows commands were not executed and are marked UNVERIFIED wherever they appear.
| Task | Open |
Where the Health section sits in MACHINE.md, the baseline and drift format, verdicts, the change log entry, the reply to the owner | machine-md-format.md |
| CPU model, microcode, governor and power profile, temperatures, throttling | cpu.md |
| RAM modules, speed against rating and vendor support, mixed kits, channels, memory errors, memory tests | memory.md |
| SMART and NVMe health, filesystem errors, free space, mount options, encryption | storage.md |
| Failed units, coredumps, error logs, kernel warnings and taint | system-errors.md |
| PATH duplicates, missing entries, shadowed binaries, which file sets what, where variables and zsh files belong, whether graphical apps see them | paths-and-environment.md |
Pending and partial upgrades, .pacnew and friends, orphans, caches | packages.md |
| GPU driver, display refresh, audio, network, firewall, time sync and the dual boot clock | devices-and-network.md |
| Firewall, Secure Boot, disk encryption, pending security updates in one view | security-baseline.md |
When to activate
- The machine was just set up and the owner wants a health baseline
- The owner asks what changed, broke or drifted since the last check
- A crash, a slow boot, a freeze or a disk warning needs a structured look first
- A question about whether RAM, a disk, the GPU driver or a display is running the way it should
MACHINE.mdexists and its Health section is missing or older than the owner wants- Also covers CPU microcode, governor, temperatures and throttling, RAM speed against the module rating and the CPU vendor's supported speed, mixed kits, channels and memory errors, SMART and NVMe health, filesystem errors, free space, mount options, encryption, failed units, crashes and error logs, PATH duplicates, shadowed binaries and env file placement, pending updates, GPU driver, display refresh rate, audio, network, firewall, time sync, Secure Boot
- The user says "take a baseline", "is my RAM at the right speed", "why is PATH so long", "is the firewall on" or "how do I run a memory test"
When not to activate
- Writing
MACHINE.mdfrom nothing, runglobal/bootstrap-machine.prompt.mdfrom agent-standards first, then come back for the baseline - Fixing a finding, which belongs to the owner, guided by
arch-linux,cachyos,windowsormacos - Writing a script that automates these checks, use
bashorpowershell - Auditing scheduled jobs, hooks and CI rather than the machine, use
automation-inventory - Reviewing code for vulnerabilities, use
application-security-review
Hard rules
- Read
MACHINE.mdfirst: the never-touch table, the owner rows, Known quirks and the last Health entry. Without it there is no baseline, so the run becomes the baseline. - Read-only. No install, no service change, no mount, no repair tool, no
fsck,chkdsk /f,ntfsfix,btrfs check --repair, no cache cleaning and no package removal, even a dry run that writes state. A missing tool is a finding, not something to install. - Never run
sudo,doas,pkexec,runas, an elevated PowerShell or anything that asks for a password. A check that needs root goes into the Needs root section asneeds: sudo <command>orneeds: elevated <command>with the row it fills. - A device in the never-touch table gets listing level only (
lsblk,Get-Disk,diskutil list). No SMART query, no filesystem tool, no mount, even read-only. - Every value carries the command it came from and the date from the system clock. A command not executed on this OS in this run is reported as UNVERIFIED, never as a result.
- A row whose Source is
owneris never overwritten. When a measurement disagrees with it, the run records drift and leaves the row as it was. - A vendor limit, such as the CPU's supported memory speed or maximum temperature, is quoted from the vendor's page with its URL and fetch date. A remembered number is not a limit.
- Report, never fix silently. Every finding goes to the owner with the evidence, the suggested command, what it changes and how to undo it. The owner decides.
- No secret in the report: no key, passphrase, token, serial number or environment variable value. Variable names only.
- Add a dated change log entry to
MACHINE.mdfor every run, saying the run changed nothing on the system.
Run order
- Read
MACHINE.mdand note the OS, the never-touch devices and the date of the last Health entry. - Run the checks in the order of the table above, OS by OS, using only the commands marked for that OS.
- Give each check a verdict from machine-md-format.md, and compare it with the baseline when one exists.
- Write the baseline or the drift entry, update Needs root, add the change log entry.
- Reply to the owner with the findings ordered by severity, each with its suggested fix handed over rather than applied.
Related skills
arch-linux,cachyos,kde-plasmaown fixing what the Linux checks findwindowsowns fixing what the Windows checks find, including BitLocker, Fast Startup and the dual boot clockmacosowns fixing what the macOS checks findresearchowns looking up and quoting the vendor limits the RAM and CPU checks compare againstautomation-inventoryowns auditing the automations that run on the machine- The
security-auditoragent owns judging whether a security finding is acceptable
Checklist
MACHINE.mdread, never-touch devices noted, owner rows left alone- Every check run read-only, nothing installed, nothing repaired, nothing elevated
- Every root or elevated command written to Needs root with the row it fills
- Every vendor limit quoted with its URL and fetch date
- Every command not executed in this run marked UNVERIFIED
- On Linux with a systemd user session and zsh as the login shell: variables and PATH entries both graphical applications and terminals need live in
~/.config/environment.d/*.conf,~/.zshenvonly imports them, setsZDOTDIRand deduplicates PATH, interactive-only setup sits in.zshrc,~/.profileholds nothing while zsh is the login shell, and the graphical session's environment matches the terminal's - On Linux with a systemd user session and zsh as the login shell: zsh files live in
$ZDOTDIR,~/.config/zsh, with~/.zshenvthe only one left in the home directory - Baseline written on the first run, drift against it on every later run
- Findings handed to the owner with evidence, fix and undo, none applied
- Change log entry added for the run
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

