Repository navigation
How Verdicts Are Reached
The rules below are read from scripts/tech.py 0.1.1. Thresholds are fixed in the script; there are no settings.
net stops at the first rung that fails:
| Rung | Test | Verdict when it fails |
|---|---|---|
| Link | an adapter has an IPv4 default gateway in ipconfig
|
no-link |
| Router | 4 pings to the gateway lose 50% or more | local-network |
| Internet | 4 pings to 1.1.1.1 lose 50% or more |
isp |
| DNS |
example.com does not resolve |
dns |
| Quality | any loss to 1.1.1.1, or an average over 100 ms |
degraded |
If every rung passes, the verdict is ok. Two further checks add advice without changing the verdict:
- Wi-Fi signal under 40% (from
netsh wlan show interfaces, connected adapter only). - Any loss, or an average over 30 ms, to your own router: that points at Wi-Fi interference or a cable, not the ISP.
A wired PC has no connected Wi-Fi adapter, so wifi is None and only the ping and DNS rungs count.
| Condition | Finding |
|---|---|
| a volume under 10% free | clear space before it slows updates |
HealthStatus anything but Healthy
|
STOP: back up now, then replace the drive |
| any uncorrected read or write errors |
STOP: back up now |
| wear 80% or more | plan a replacement |
| temperature 70 C or more | check airflow |
The last three need the reliability counters, which need an administrator shell.
A copy counts only when it is configured, not when the software is merely installed:
| Copy | Counted when | Media | Off-site |
|---|---|---|---|
| original | always | this PC | no |
| File History | its configuration is readable | external or network drive | no |
| OneDrive | the OneDrive environment variable points to a folder that exists |
cloud | yes |
| system image |
wbadmin get versions lists a backup time |
backup drive | no |
each --target
|
always, as declared | its own | no |
The verdict is 3-2-1 met when there are at least three copies, at least two kinds of media and at least one off-site copy; otherwise gaps, with one finding per missing part. OneDrive always adds a warning that sync is not a true backup, since deletions and ransomware sync too. Since 0.1.1 a failed restore test overrides both verdicts with restore failed.
So a PC with OneDrive and one declared USB drive meets 3-2-1 on paper. The restore test is what shows the USB copy is real.
health gives a plain meaning for these System-log events (provider and event ID):
| Event | Meaning |
|---|---|
| Microsoft-Windows-Kernel-Power, 41 | unexpected shutdowns (power loss, PSU, overheating or a crash) |
| disk, 7 |
STOP: bad blocks on a disk |
| disk, 153 | disk I/O retries: check the cable or port |
| Microsoft-Windows-WHEA-Logger, 1 | hardware error: check temperatures, RAM and overclocks |
| Microsoft-Windows-WHEA-Logger, 18 | fatal hardware error: take it in if it repeats |
| Microsoft-Windows-WindowsUpdateClient, 20 | Windows Update installs failing |
| Ntfs, 55 | file system corruption: back up, then chkdsk (ask first; needs a reboot) |
Defender adds a finding when real-time protection is off or the signatures are more than seven days old.
These come from the skill, not the script: a burning smell, a swollen battery, liquid damage, a cracked charger, a clicking drive whose data has no backup, repeated fatal hardware errors, or a fix that needs a laptop under warranty opened. The skill says so plainly and points to the maker's support or a repair shop.
This wiki describes techwright 0.1.1 and was last updated on 2026-11-21. The plugin is MIT licensed. Report problems in the issues. Source: m4bwav/techwright.
Using it
The releases
Contributing
Elsewhere