本文へ移動
cccskills
無料GitHub で公開日本語紹介

homelab-network-readiness

家庭や小規模ラボのネットワーク変更前に、機器構成と復旧手順を整理するスキル。VLANによる分離、DNSフィルタリング、VPN導入を段階的に計画・点検します。

原文原文の説明を見る

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.

インストール方法を見る

こんなときに便利

  • 普段使う端末とIoT・来客端末の分離
  • DNSフィルタリングへの移行計画
  • VPNによる遠隔アクセスの見直し
  • ネットワーク変更前の復旧経路確認

日本語での紹介

できること

家庭や小規模ラボのネットワークを変更する前に、構成・リスク・確認方法・復旧手順を整理します。VLANによる機器グループの分離、Pi-holeやAdGuard HomeなどによるDNSフィルタリング、VPN経由の遠隔アクセスが対象です。ルーター、スイッチ、Wi-Fi、IPアドレス、管理画面への接続経路を確認し、少数の端末で試してから広げる移行計画を組み立てます。

こんなときに便利

IoT機器や来客用端末を普段使う端末から分けたい場合や、DNS設定・VPNを見直す場合に向いています。変更後に管理画面へ入れなくなる可能性や、DNS障害時に復旧できるかを事前に点検したいときにも使えます。

使い方の例

  • 「自宅のネットワークをIoT用と来客用に分ける準備を確認して」
  • 「Pi-holeを導入する段階的な移行計画を作って」
  • 「NASへのVPN接続範囲と復旧手順をレビューして」

注意点

計画とレビューを目的とするスキルです。設定コマンドの提示には、対象機器や環境、復旧手順の確認が必要です。管理用ネットワークやDHCP・DNSなどの変更前には、現地または別経路から操作できる手段を確保します。管理画面をインターネットへ直接公開しない方針です。

この紹介文は、公開されている SKILL.md をもとに AI(Claude Haiku)が作成しました。正確な仕様は下の原文を確認してください。

含まれるファイル(1)

  • SKILL.md7.6 KB

SKILL.md(原文)

インストールする前に、エージェントに与えられる指示の中身を確認できます。

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:

AreaQuestions
Internet edgeWhat is the modem or ONT? Is the ISP router bridged or still routing?
GatewayWhat routes, firewalls, handles DHCP, and terminates VPNs?
SwitchingWhich switch ports are uplinks, access ports, trunks, or unmanaged?
Wi-FiWhich SSIDs map to which networks, and are APs wired or mesh?
AddressingWhat subnets exist today, and which ranges conflict with VPN sites?
DNS/DHCPWhich service currently hands out leases and resolver addresses?
ManagementHow will the operator reach the gateway, switch, and AP after changes?
RecoveryWhat can be reverted locally if DNS, DHCP, VLANs, or VPN routes break?

VLAN And Trust-Zone Plan

Start with intent rather than vendor syntax.

ZoneTypical contentsDefault policy
TrustedLaptops, phones, admin workstationsCan reach shared services and management only when needed
ServersNAS, Home Assistant, lab hosts, DNS resolverAccepts narrow inbound flows from trusted clients
IoTTVs, smart plugs, cameras, speakersInternet access plus explicit exceptions only
GuestVisitor devicesInternet-only, no LAN reachability
ManagementGateway, switches, APs, controllersReachable only from trusted admin devices
VPNRemote clientsSame or narrower access than trusted clients

Before recommending VLAN IDs or subnets, confirm:

  1. The gateway supports inter-VLAN routing and firewall rules.
  2. The switch supports the required tagged and untagged port behavior.
  3. The APs can map SSIDs to VLANs.
  4. The operator knows which port they are connected through during the change.
  5. 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.

  1. Give the resolver a reserved address before using it in DHCP options.
  2. Confirm it can resolve public DNS and local home.arpa names.
  3. Keep the gateway or a second resolver available as a temporary fallback.
  4. Test one client or one VLAN before changing every DHCP scope.
  5. Document which networks may bypass filtering and why.
  6. 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 generating keys or opening ports.

ModeUse whenRisk notes
Split tunnel to one subnetRemote admin for NAS or lab hostsKeep route list narrow
Split tunnel to trusted servicesAccess selected apps by IP or DNSRequires precise firewall rules
Full tunnelUntrusted networks or travelMore bandwidth and DNS responsibility
Overlay VPNSimpler remote access with identity controlsStill needs ACL review

Do not recommend port forwarding until the operator confirms:

  • The VPN endpoint is patched and actively maintained.
  • The forwarded port goes only to the VPN service, not an admin UI.
  • Dynamic DNS, public IP behavior, and ISP CGNAT status are understood.
  • Peer keys can be revoked without rebuilding the whole network.
  • Logs or connection status can verify who connected and when.

Change Sequence

Prefer small, reversible changes:

  1. Snapshot the current topology, IP plan, DHCP settings, DNS settings, and firewall rules.
  2. Reserve infrastructure addresses for gateway, DNS, controller, APs, NAS, and VPN endpoint.
  3. Create the new zone or VLAN without moving critical devices.
  4. Move one test client and validate DHCP, DNS, routing, internet, and block behavior.
  5. Add narrow firewall exceptions for required flows.
  6. Move one low-risk device group.
  7. Add VPN access with the narrowest route and firewall policy that satisfies the use case.
  8. Document final state, known exceptions, and rollback commands or UI steps.

Review Checklist

  • Each network has a reason to exist and a clear trust boundary.
  • No management interface is reachable from guest, IoT, or the public internet.
  • DNS failure does not take down the operator's ability to recover locally.
  • DHCP scope changes were tested on one client before broad rollout.
  • VPN clients receive only the routes and DNS settings they need.
  • Firewall rules are default-deny between zones, with named exceptions.
  • The operator can still reach gateway, switch, AP, DNS, and VPN admin surfaces.
  • Rollback is documented in the same vocabulary as the chosen platform UI or CLI.

Anti-Patterns

  • Segmenting networks before knowing which switch ports and SSIDs carry which VLANs.
  • Moving the admin workstation off the only reachable management network.
  • Pointing all DHCP scopes at a Pi-hole before testing fallback DNS.
  • Publishing NAS, DNS, router, or hypervisor management directly to the internet.
  • Treating VPN access as equivalent to full trusted-LAN access.
  • Adding allow-all firewall rules temporarily and forgetting to remove them.
  • Copying commands from another vendor or firmware version without checking the exact platform syntax.

See Also

  • Skill: homelab-network-setup
  • Skill: network-config-validation
  • Skill: network-interface-health

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

同じリポジトリのスキル

概要と使いどころ

accessibility

無料日本語概要

Web・iOS・Androidの画面を、読み上げやキーボード操作に対応させ、ラベル、配色、操作対象の大きさなどをWCAG 2.2に沿って設計・点検するスキル。

  • アイコンボタンの説明を付けたいとき
  • キーボード操作とモーダルの点検
  • コントラストや操作対象の大きさの確認
affaan-m/ECC27.8万2026年10月12日 更新

agent-architecture-audit

無料日本語概要

AIエージェントの不調を、指示・記憶・ツール実行・画面表示など12の層から調べるスキル。コードやログを根拠に原因を整理し、重要度順の指摘と修正案をまとめます。

  • アプリ内だけで起きる不調を調べたいとき
  • 過去の会話が混ざる原因を調査
  • ツールの未実行や実行の誤報を確認
affaan-m/ECC27.8万2026年10月12日 更新

agent-eval

無料日本語概要

実際の開発課題で複数のコーディングエージェントを比較するスキル。成功率、取得可能なAPI費用、所要時間、繰り返し実行の安定性を測り、選定や更新後の評価に使えます。

  • 実際の開発課題でエージェントを比較
  • 新しいツールやモデルの導入前評価
  • エージェント更新後の性能確認
affaan-m/ECC27.8万2026年10月12日 更新

agent-harness-construction

無料日本語概要

AIエージェントが使うツールの種類や入出力、エラーからの復帰手順を設計・見直します。文脈の情報量も整理し、作業完了率や再試行回数で改善を評価します。

  • エージェントのツールや入力形式の設計
  • ツールの結果と次の行動を明確にしたいとき
  • 安全な再試行と停止条件を定めたいとき
affaan-m/ECC27.8万2026年10月12日 更新

agent-introspection-debugging

無料日本語概要

AIエージェントの失敗や同じ操作の繰り返しを記録し、原因の切り分け、小さな復旧操作、結果の報告まで進める手順を示して、根拠のある再試行につなげるスキル。

  • 同じツール操作を繰り返す原因の調査
  • 会話の肥大化による品質低下の調査
  • ファイルパスや環境の食い違いの確認
affaan-m/ECC27.8万2026年10月12日 更新

agent-introspection-debugging

無料日本語概要

AIエージェントが失敗や同じ操作を繰り返す原因を、エラーと実行状況から整理します。小さな復旧操作を試し、結果と根拠を引き継げる報告にまとめるスキルです。

  • エージェントの連続失敗を診断したいとき
  • 同じツール操作のループ調査
  • 情報の蓄積による出力劣化の点検
affaan-m/ECC27.8万2026年10月5日 更新

affaan-m のスキルをすべて見る

このスキルの問題を報告する