Skip to content
Back to search

desktopdiag

MarketplaceWorks with Claude CodeGitHub

DesktopDiag: a read-only Windows PC health check skill for Claude Code, with French and English reports.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/lykroze9--desktopdiag-skill/badge.svg)](/listings/lykroze9--desktopdiag-skill)

HTML

<a href="/listings/lykroze9--desktopdiag-skill"><img src="/api/listings/lykroze9--desktopdiag-skill/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

As a Claude Code plugin:

/plugin marketplace add Lykroze9/DesktopDiag-Skill
/plugin install desktopdiag@desktopdiag

Or as a standalone skill: copy `skills/desktopdiag` to `%USERPROFILE%\.claude\skills\desktopdiag` (all projects) or to `.claude\skills\desktopdiag` in a project.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 14 lines
  1. {
  2. "name": "desktopdiag",
  3. "owner": {
  4. "name": "Lykroze"
  5. },
  6. "description": "DesktopDiag: a read-only Windows PC health check skill for Claude Code, with French and English reports.",
  7. "plugins": [
  8. {
  9. "name": "desktopdiag",
  10. "source": "./",
  11. "description": "Read-only Windows PC health check: crashes/BSOD, GPU resets, SSD wear, hardware errors, boot time, CPU throttling, security. French and English reports."
  12. }
  13. ]
  14. }
README.md · README · 123 lines
  1. # DesktopDiag for Claude Code
  2. ### Is your PC slow, glitchy, crashing... or do you just want a quick checkup?
  3. **A read-only Windows PC health check skill for [Claude Code](https://claude.com/claude-code).** Ask
  4. "check my PC" or describe a problem ("my screen goes black in games", "random reboots") and Claude
  5. collects the data, explains it in plain language, scores your PC and tells you what to do next.
  6. Reports in **English or French**.
  7. > **🖥️ No Claude?** The same checks exist as a free, portable Windows app:
  8. > **[DesktopDiag](https://github.com/Lykroze9/DesktopDiag)** (one 1 MB file, nothing to install, one click).
  9. [🇫🇷 Version française](README.fr.md)
  10. > **👋 A personal side project.** DesktopDiag started as a custom tool I built for my own PC, after
  11. > chasing GPU freezes and blue screens, and grew into a skill I wanted to share. It is not a
  12. > commercial product and it is far from finished.
  13. >
  14. > **Your feedback is very welcome!** Tried it? Found a bug, a wrong diagnosis, a missing check, or
  15. > just have an idea? Please [open an issue](https://github.com/Lykroze9/DesktopDiag-Skill/issues) or start a
  16. > [discussion](https://github.com/Lykroze9/DesktopDiag-Skill/discussions), in English or French. Every comment helps make the skill better.
  17. ## Install
  18. As a Claude Code plugin:
  19. ```
  20. /plugin marketplace add Lykroze9/DesktopDiag-Skill
  21. /plugin install desktopdiag@desktopdiag
  22. ```
  23. Or as a standalone skill: copy `skills/desktopdiag` to `%USERPROFILE%\.claude\skills\desktopdiag`
  24. (all projects) or to `.claude\skills\desktopdiag` in a project.
  25. ## Use
  26. Just talk to Claude Code:
  27. - "Check my PC" / "Is my PC healthy?"
  28. - "My screen goes black for a few seconds when I play"
  29. - "My PC rebooted by itself twice this week"
  30. - "Is my SSD OK?"
  31. - "Do a full check" (proposes the admin deep scan)
  32. - "Make a shareable report for a forum"
  33. - "Schedule a check every month" / "Check again in 4 days"
  34. ## What it checks
  35. | Area | Details |
  36. |---|---|
  37. | Stability | Blue screens (stop code + parameters), unexpected shutdowns, crash dumps, Windows reliability index |
  38. | Graphics | Display driver resets (TDR), NVIDIA/AMD/Intel driver errors, driver version and age, overclocking tools at startup |
  39. | Storage | Free space, disk health, SSD wear/temperature/errors (SMART via smartctl), disk errors mapped to the right drive (USB vs system SSD) |
  40. | Hardware | WHEA hardware errors (CPU, RAM, PCIe), Windows Memory Diagnostic result, TPM errors, devices in error (code 10/43...) |
  41. | Security | Antivirus status, firewall profiles, last successful Windows Update and recent failures, pending reboot, UAC, Secure Boot |
  42. | Performance | Real CPU % (sampled, not cumulative), RAM and commit usage, top processes |
  43. | Boot time | Firmware/BIOS time of each boot, Fast Startup; with admin: total boot time and what slowed each boot down (app, driver, service) |
  44. | Heat | CPU throttling by firmware (heat or power limits), live performance limit, thermal zones when the PC exposes them |
  45. | Network | Wi-Fi signal, router ping, DNS response time, Wi-Fi and Ethernet drops |
  46. | Battery | Laptops: health (current vs original capacity) and charge cycles |
  47. | Maintenance | Startup entries, temp folders, uptime, page file and hibernation file size |
  48. | History | Every check is saved locally and compared with the previous one: new crashes since last time, space lost, driver/BIOS updates, startup entries added |
  49. | Follow-up | After each report, Claude proposes the next check sized to what it found (in 2-4 days after a fix, weekly while problems settle, monthly otherwise) and schedules it on your OK with the Claude desktop app's local scheduled tasks |
  50. ## Why another one?
  51. Existing Windows diagnostic skills/MCP servers skip the problems people actually hit: GPU driver
  52. resets, NVMe wear, BSOD culprit drivers, and "did it get better since last week?". DesktopDiag
  53. also:
  54. - runs on the **built-in Windows PowerShell 5.1** (no PowerShell 7, Node or Python needed), Windows 10 and 11;
  55. - needs **no admin** for the main check; an optional admin step adds SMART, dump analysis and a read-only file system scan;
  56. - is **read-only**: fixes are proposed with risk levels and run only after your explicit OK;
  57. - documents real-world traps (inflated crash counts in the Application log, `chkdsk` access denied, vendor utilities reinstalling drivers, sandboxed registry writes...);
  58. - has a **share mode** that strips user name, computer name and paths for forum posts.
  59. ## Scripts
  60. You can also run the collector yourself:
  61. ```powershell
  62. powershell -NoProfile -ExecutionPolicy Bypass -File skills\desktopdiag\scripts\collect.ps1
  63. powershell -NoProfile -ExecutionPolicy Bypass -File skills\desktopdiag\scripts\compare.ps1
  64. ```
  65. Add `-Summary` to `collect.ps1` for a compact digest (about 10x smaller than the full snapshot).
  66. Claude uses it by default, so each check costs far fewer tokens. Snapshots are stored in
  67. `%LOCALAPPDATA%\DesktopDiag\history` (shared with the Windows app).
  68. ## Score
  69. The score and the area levels come from `skills/desktopdiag/rules/rules.json`, applied by
  70. `scripts/score.ps1`: the same PC always gets the same score, and Claude adds the explanations.
  71. Thresholds are documented in [rules/README.md](skills/desktopdiag/rules/README.md). The
  72. [Windows app](https://github.com/Lykroze9/DesktopDiag) embeds these same scripts and rules.
  73. ## Development
  74. ```powershell
  75. powershell -NoProfile -ExecutionPolicy Bypass -File tests\run-tests.ps1 -Live
  76. ```
  77. Tests use synthetic snapshots (`tests/fixtures.ps1`, no real machine data) and run on every push
  78. with GitHub Actions, together with PSScriptAnalyzer. See [CHANGELOG.md](CHANGELOG.md) for what changed.
  79. ## Optional tools
  80. - [smartmontools](https://www.smartmontools.org/) (`winget install smartmontools.smartmontools`) for detailed SSD/HDD SMART data.
  81. - WinDbg (`winget install Microsoft.WinDbg`) to identify the driver behind a blue screen. The first analysis downloads public symbols from Microsoft.
  82. ## Privacy
  83. Everything runs locally. Nothing is uploaded (except Microsoft symbol downloads if you accept dump
  84. analysis). Disk serial numbers are hashed. Use share mode before posting a report anywhere.
  85. ## Disclaimer
  86. DesktopDiag reads system information and gives advice. It does not replace a technician. Hardware
  87. interventions (BIOS updates, repasting, part replacement) are your decision and responsibility.
  88. ## License
  89. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.