Repository navigation
Development
| Path | What |
|---|---|
.claude-plugin/plugin.json, marketplace.json
|
plugin and marketplace manifests (the version lives in plugin.json) |
skills/techwright/SKILL.md |
the skill: rules, commands, routing |
skills/techwright/references/ |
troubleshoot.md, network.md, backup.md, buying.md, homelab.md
|
scripts/tech.py |
the read-only checks, standard library only |
tests/test_tech.py |
unit tests on fixture text |
evals/evals.json, evals/fixtures/
|
skill eval cases with no-skill baselines |
evergreen.json, RESEARCH.md, LEARNINGS.md, TESTS.md, CHANGELOG.md
|
evergreen upkeep: refresh schedule, research, lessons, test runs |
python -m pytestor python -m unittest discover -s tests. The parsers (netsh, ipconfig, ping on Windows and POSIX), the network verdicts, the disk and health findings, the backup table and the restore test run on fixture text, so the tests pass on any system. 0.1.1 has 12 tests. There is no CI; run them before a pull request.
Each command collects raw output with run(), which never raises (a missing program or a timeout comes back as code -1 with the error text), and hands it to a pure function: parse_wlan_interfaces, parse_ipconfig_gateways, parse_ping, net_verdict, disk_findings, backup_table, restore_test, health_findings. Those functions are what the tests call. PowerShell queries are kept in the DISK_PS, BACKUP_PS and HEALTH_PS strings and return JSON.
To add a known event, add its "Provider, Id" key and a plain meaning to KNOWN_EVENTS, and a test case in tests/test_tech.py.
evals/evals.json holds five cases (restore, 3-2-1, battery, router, prices), each run with the skill and without it. Results are recorded in TESTS.md.
Bump version in .claude-plugin/plugin.json, add a CHANGELOG.md entry, merge, tag vX.Y.Z on main, and create the GitHub release. Then update this wiki's Versions and upgrading page and the footer.
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