Imported from ythx-101/lan-control (SKILL.md). Install upstream with npx skills add ythx-101/lan-control. Copyright stays with the author.

Router Control

Name: router-control
Author: ythx-101

Universal home router discovery and device management. Zero config — auto-detects your router, finds all devices, identifies them from community-maintained YAML profiles.

Quick Start

python3 cli.py discover        # Find router + all LAN devices
python3 cli.py connect         # SSH into router (key → password → defaults)
python3 cli.py devices         # List devices with type identification
python3 cli.py supported       # What devices are supported
python3 cli.py commands lg-webos  # What can this device do
python3 cli.py health          # Router health check

How It Works

discover.sh — Finds router via default gateway, detects fake IPs (Clash TUN), probes SSH/HTTP
connect.sh — Establishes SSH (tries key → password → common defaults)
devices.sh — Reads DHCP leases, matches against devices/**/*.yaml profiles via registry.py
registry.py — Auto-scans all YAML in devices/, provides identify(mac, hostname) matching

Device Profiles

Community-maintained YAML files in devices/<type>/:

devices/
  router/    OpenWrt, GL.iNet, ASUS Merlin, TP-Link
  tv/        LG webOS, Samsung Tizen, Roku
  ir-remote/ BroadLink, Tuya IR
  speaker/   Google Nest, Amazon Echo
  camera/    Reolink, Hikvision
  ac/        Generic IR AC
  iot/       ESP/Tuya, Tasmota

Each YAML defines: device (metadata), discovery (MAC/hostname/mDNS), connection (protocol/auth), commands (what the device can do).

See devices/_schema.yaml for the template. Full schema: references/device-schema.md.

Adding a New Device

Create devices/<type>/my-device.yaml (copy from _schema.yaml)
Fill in discovery (MAC prefix + hostname pattern), connection, commands
Test: python3 cli.py supported should list it
Submit PR

See references/contributing.md for the full guide.

Shell Scripts (Advanced)

Direct router access when you need raw control:

bash scripts/run.sh "wg show"           # Run any command on router
bash scripts/ping.sh "LGwebOSTV"        # Ping by hostname
bash scripts/health.sh                  # Full health dump

Troubleshooting

See references/troubleshooting.md for:

Fake IPs (VPN/Clash TUN masquerading as router)
ISP port blocking on WireGuard
SSH auth failures with Dropbear
Double NAT detection
Router memory pressure

{ "ocm": "1", "id": "ythx-101-lan-control-router-control", "kind": "skill", "name": "router-control", "description": "Universal home network discovery and device control via router. Use when: (1) discovering devices on local network, (2) SSH into a router, (3) managing WireGuard/VPN on a router, (4) setting up AdGuard Home / DNS filtering, (5) controlling smart home devices found via DHCP, (6) checking device online status. Works with any router (OpenWrt, GL.iNet, ASUS, TP-Link, etc.) — auto-detects model and capabilities. Designed for local Mac/Linux deployment with OpenClaw.", "publisher": "ythx-101", "version": "1.0.0", "capabilities": { "domains": [ "general" ], "tags": [ "skill-md", "github" ], "languages": [ "en" ] }, "quality_prior": 0.6, "examples": [ "Universal home network discovery and device control via router. Use when: (1) discovering devices on local network, (2) SSH into a router, (3) managing WireGuard/VPN on a router, (4) setting up AdGuard Home / DNS filtering, (5) controlling smart home devices found via DHCP, (6) checking device online status. Works with any router (OpenWrt, GL.iNet, ASUS, TP-Link, etc.) — auto-detects model and capabilities. Designed for local Mac/Linux deployment with OpenClaw." ], "primary": false, "metadata": { "source": { "provider": "github", "repository": "https://github.com/ythx-101/lan-control", "path": "SKILL.md", "ref": "55c8a44a934685dc1981129d6b4ade5d1c1d37f0", "url": "https://github.com/ythx-101/lan-control/blob/55c8a44a934685dc1981129d6b4ade5d1c1d37f0/SKILL.md", "key": "ythx-101/lan-control/SKILL.md" } }, "instructions": "# Router Control\n\nUniversal home router discovery and device management. Zero config — auto-detects your router, finds all devices, identifies them from community-maintained YAML profiles.\n\n## Quick Start\n\n```bash\npython3 cli.py discover # Find router + all LAN devices\npython3 cli.py connect # SSH into router (key → password → defaults)\npython3 cli.py devices # List devices with type identification\npython3 cli.py supported # What devices are supported\npython3 cli.py commands lg-webos # What can this device do\npython3 cli.py health # Router health check\n``", "cost": { "context_tokens": 592 } }

router-control

About

Router Control

Quick Start

How It Works

Device Profiles

Adding a New Device

Shell Scripts (Advanced)

Troubleshooting

Use it

Manifest

Reviews