Skip to content
Back to search

wifi-doctor

SkillWorks with Claude CodeGitHub

Diagnose and fix slow Wi-Fi on a Mac. Use when the user says the internet or Wi-Fi is slow, laggy, dropping, or asks who is on their network. Runs a read-only check (signal, channel, neighbours, DNS, ping, speed, apps, devices), then walks through fixes one by one with the user's consent.

Safety scan

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

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/rakhimovy--wifi-doctor/badge.svg)](/listings/rakhimovy--wifi-doctor)

HTML

<a href="/listings/rakhimovy--wifi-doctor"><img src="/api/listings/rakhimovy--wifi-doctor/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

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

npx skills add RakhimovY/wifi-doctor -g

or by hand:

git clone https://github.com/RakhimovY/wifi-doctor ~/.claude/skills/wifi-doctor   # Claude Code
git clone https://github.com/RakhimovY/wifi-doctor ~/.agents/skills/wifi-doctor   # Codex and others

Then ask your agent: "find what makes my games lag" or "find everything that slows down my Wi-Fi".

Safety approach adapted from [iAmCorey/wifi-optimizer](https://github.com/iAmCorey/wifi-optimizer) (MIT). License: MIT.

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.

SKILL.md · Manifest · 48 lines
  1. ---
  2. name: wifi-doctor
  3. description: Diagnose and fix slow Wi-Fi on a Mac. Use when the user says the internet or Wi-Fi is slow, laggy, dropping, or asks who is on their network. Runs a read-only check (signal, channel, neighbours, DNS, ping, speed, apps, devices), then walks through fixes one by one with the user's consent.
  4. ---
  5. # Wi-Fi Doctor (macOS)
  6. Built-in macOS commands only. Nothing to install.
  7. ## 1. Diagnose (read only)
  8. Run the script from this skill's own folder (wherever it is installed: `~/.claude/skills/`, `~/.agents/skills/` or a project's skills folder):
  9. ```bash
  10. bash scripts/diagnose.sh
  11. ```
  12. Takes about a minute (`--quick` skips the speed test). It changes nothing. It prints: connection, signal/noise, channel and neighbours, DNS time, latency to the router vs the internet, speed and responsiveness, top network apps, devices on the network, and a fix list sorted HIGH / MED / LOW.
  13. Explain the result in plain words. The key verdict is router ping vs internet ping:
  14. - router ping bad: the problem is Wi-Fi inside the home (signal, channel, interference);
  15. - router fine, internet bad: the problem is the provider.
  16. Devices: for each `oui XX:XX:XX`, name the vendor (from your knowledge, or `curl -s https://api.macvendors.com/XX:XX:XX`). `private-MAC` is usually a phone or laptop with MAC randomization. Ask the user which devices are theirs. Never call a device malicious without proof.
  17. ## 2. Fix (one change at a time)
  18. Go down the fix list in order. For each fix:
  19. 1. Say what will change, why, and the expected effect.
  20. 2. Ask for an explicit "yes" for this one change. No yes, no change.
  21. 3. Before changing anything, write down the current value (old channel, width, band, DNS, firmware version) so it can be rolled back.
  22. 4. Make the change, or let the user make it.
  23. Rules:
  24. - Router changes (channel, width, band, DNS, firmware, blocking a device) are done in the router admin page, usually at the router IP from the report. Prefer guiding the user through it. If you drive the browser, the user types the router password themselves. Never ask for the password in chat and never store it.
  25. - Mac-side changes (e.g. DNS) need a yes too. Record the old value first: `networksetup -getdnsservers Wi-Fi`. Rollback: `networksetup -setdnsservers Wi-Fi <old values>` (or `Empty`).
  26. - Never change anything that would cut the connection without warning the user first (channel or band changes drop Wi-Fi for a few seconds).
  27. - Firmware: only point the user to the update; never flash firmware yourself.
  28. - Provider problems cannot be fixed at home: give the user the numbers to send to the ISP.
  29. ## 3. Verify
  30. Re-run `diagnose.sh` and show a short before / after table: speed down/up, responsiveness, signal, neighbours on the channel, DNS time, router and internet ping. If something got worse, offer to roll back with the recorded old value.
  31. ## Credits
  32. The safety approach (read-only first, explicit consent per change, record old values for rollback, the user types router passwords) is adapted from [iAmCorey/wifi-optimizer](https://github.com/iAmCorey/wifi-optimizer) (MIT).
README.md · README · 20 lines
  1. # wifi-doctor
  2. A small AI agent skill (Claude Code, Codex and other agents that read Agent Skills) that finds out why your Mac's Wi-Fi is slow and helps fix it. It checks signal, channel crowding, DNS, router vs provider latency, lag under load, speed, the apps and the devices on your network using only built-in macOS commands, then suggests fixes in order and changes nothing without your yes (old values are saved for rollback, and you type the router password yourself).
  3. ## Install
  4. ```
  5. npx skills add RakhimovY/wifi-doctor -g
  6. ```
  7. or by hand:
  8. ```
  9. git clone https://github.com/RakhimovY/wifi-doctor ~/.claude/skills/wifi-doctor # Claude Code
  10. git clone https://github.com/RakhimovY/wifi-doctor ~/.agents/skills/wifi-doctor # Codex and others
  11. ```
  12. Then ask your agent: "find what makes my games lag" or "find everything that slows down my Wi-Fi".
  13. Safety approach adapted from [iAmCorey/wifi-optimizer](https://github.com/iAmCorey/wifi-optimizer) (MIT). License: MIT.

Ratings and comments

Sign in to rate this skill.

Sign in

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