homelab-network-readiness
Checks home network readiness for VLAN segmentation, DNS filtering, and secure remote access.
What it does
This agent helps you plan and review changes to your home network. It checks if you're ready to organize your network into 'zones' (like one for guests and another for smart devices), set up a local ad blocker (like Pi-hole), or add secure remote access to your network when you're away.
When to use it
- ✓Before splitting your current network into smaller networks (VLANs).
- ✓When planning to use an ad blocker (Pi-hole) for all devices.
- ✓When you want to securely access your home network from anywhere.
Example of what to ask your AI
“I'm thinking about splitting my network for guests and smart home devices. What do I need to check before I start?”
Want more? Open the sections below.
How to use
The easiest way: copy the message below and paste it into Claude, ChatGPT, Cursor or any AI. It reads the skill and follows the instructions.
Skill link
Ready-to-paste message
How it works
It asks questions about your current network (router, Wi-Fi, etc.) and your plans. Based on your answers, it points out risks and suggests a step-by-step plan to make changes safely, ensuring you don't lose access to your own network.
Installation
Easiest way: copy the skill link and paste it into Claude, ChatGPT or Cursor asking it to follow the instructions.
In the terminal (Claude Code, Codex, Cursor), in your project folder:
npx skills add affaan-m/ECC --skill homelab-network-readinessOr download just the file:
curl -L https://raw.githubusercontent.com/affaan-m/ECC/main/skills/homelab-network-readiness/SKILL.md -o SKILL.mdTechnical content (original SKILL.md)
Original text by the author, straight from GitHub.
Homelab Network Readiness
Use this skill before changing a home or small-lab network that mixes VLANs, Pi-hole or another local DNS resolver, firewall rules, and remote VPN access.
This is a planning and review skill. Do not turn it into copy-paste router, firewall, or VPN configuration unless the target platform, current topology, rollback path, console access, and maintenance window are all known.
When to Use
- Preparing to split a flat network into trusted, IoT, guest, server, or management VLANs.
- Moving DHCP clients to Pi-hole, AdGuard Home, Unbound, or another local DNS resolver.
- Adding WireGuard, Tailscale, ZeroTier, OpenVPN, or router-native VPN access.
- Reviewing whether a homelab change can lock the operator out of the gateway, switch, access point, DNS server, or VPN server.
- Turning an informal home-network idea into a staged migration plan with validation evidence.
Safety Rules
- Keep the first answer read-only: inventory, risks, staged plan, validation, and rollback.
- Do not expose gateway admin panels, DNS resolvers, SSH, NAS consoles, or VPN management UIs directly to the public internet.
- Do not provide firewall, NAT, VLAN, DHCP, or VPN commands without a confirmed platform and a rollback procedure.
- Require out-of-band or same-room console access before changing management VLANs, trunk ports, firewall default policies, or DHCP/DNS settings.
- Keep a working path back to the internet before pointing the whole network at a new DNS resolver or VPN route.
- Treat IoT, guest, camera, and lab-server networks as different trust zones until the operator explicitly chooses otherwise.
Required Inventory
Collect this before giving implementation steps:
| Area | Questions |
|---|---|
| Internet edge | What is the modem or ONT? Is the ISP router bridged or still routing? |
| Gateway | What routes, firewalls, handles DHCP, and terminates VPNs? |
| Switching | Which switch ports are uplinks, access ports, trunks, or unmanaged? |
| Wi-Fi | Which SSIDs map to which networks, and are APs wired or mesh? |
| Addressing | What subnets exist today, and which ranges conflict with VPN sites? |
| DNS/DHCP | Which service currently hands out leases and resolver addresses? |
| Management | How will the operator reach the gateway, switch, and AP after changes? |
| Recovery | What can be reverted locally if DNS, DHCP, VLANs, or VPN routes break? |
VLAN And Trust-Zone Plan
Start with intent rather than vendor syntax.
| Zone | Typical contents | Default policy |
|---|---|---|
| Trusted | Laptops, phones, admin workstations | Can reach shared services and management only when needed |
| Servers | NAS, Home Assistant, lab hosts, DNS resolver | Accepts narrow inbound flows from trusted clients |
| IoT | TVs, smart plugs, cameras, speakers | Internet access plus explicit exceptions only |
| Guest | Visitor devices | Internet-only, no LAN reachability |
| Management | Gateway, switches, APs, controllers | Reachable only from trusted admin devices |
| VPN | Remote clients | Same or narrower access than trusted clients |
Before recommending VLAN IDs or subnets, confirm:
- The gateway supports inter-VLAN routing and firewall rules.
- The switch supports the required tagged and untagged port behavior.
- The APs can map SSIDs to VLANs.
- The operator knows which port they are connected through during the change.
- The management network remains reachable after trunk and SSID changes.
DNS Filtering Readiness
Pi-hole or another local resolver should be introduced as a dependency, not as a single point of failure.
- Give the resolver a reserved address before using it in DHCP options.
- Confirm it can resolve public DNS and local
home.arpanames. - Keep the gateway or a second resolver available as a temporary fallback.
- Test one client or one VLAN before changing every DHCP scope.
- Document which networks may bypass filtering and why.
- Check that blocking rules do not break captive portals, work VPNs, firmware updates, or medical/security devices.
Useful validation evidence:
Client gets expected DHCP lease
Client receives expected DNS resolver
Public DNS lookup succeeds
Local home.arpa lookup succeeds
Blocked test domain is blocked only where intended
Gateway and DNS admin interfaces are not reachable from guest or IoT networks
Remote Access Readiness
For WireGuard-style access, decide what the VPN is allowed to reach before
…
FAQ
Why shouldn't I expose admin interfaces directly to the internet?
Exposing admin interfaces (like your router or Pi-hole's) directly to the internet makes them easy targets for hackers, who could try to steal your information or control your network.
What is 'out-of-band access'?
It's a way to access your network that doesn't rely on the network itself being changed. For example, having a cable connected directly to your computer to access the router if the Wi-Fi stops working after a change.
What is a 'trust zone'?
It's a group of devices on your network that have a similar security level. For example, your computers and phones might be in a 'trusted' zone, while IoT devices (like cameras and smart lights) might be in a 'less trusted' zone to limit damage if they get compromised.
Details
Original description by the author
Readiness checklist for homelab VLAN segmentation, local DNS filtering (Pi-hole, AdGuard Home), and WireGuard-style remote access. Use when planning or reviewing home network changes — splitting a flat network into trusted, IoT, guest, or management VLANs, moving DHCP to a local resolver, or adding VPN access — before changing router, firewall, DHCP, or VPN configuration.
repo: affaan-m/ECC
Popularity
- GitHub stars
- 280k
- Ranking position
- #206
- License
- MIT
- Updated
- 10/15/2026
Comments
- …
More skills from this repository
accessibility
Helps your agent create interfaces that everyone can use. Ensures websites and apps work well for people with disabilities, like those who are blind or have reduced mobility.
affaan-m/ECC
agent-architecture-audit
Makes your agent check if everything is working correctly. It finds and fixes problems in AI systems, ensuring they perform as expected.
affaan-m/ECC
agent-eval
Helps your agent compare different AI coding tools. It measures which one is faster, cheaper, and more reliable for specific tasks.
affaan-m/ECC
agent-harness-construction
Makes your agent better understand how to perform tasks. It optimizes the tools and instructions the agent uses to increase its chances of success.
affaan-m/ECC
Similar skills
template-skill
This is a generic template for new skills. It needs a specific description to be useful.
anthropics/skills
shipping-and-launch
Prepares your code to be safely launched into production. Helps ensure everything is ready, monitored, and has a rollback plan.
addyosmani/agent-skills
using-agent-skills
Has your agent discover and use other skills. It's useful for deciding which tool or workflow to use for a specific task.
addyosmani/agent-skills