unifi-network-ops

Inspect, troubleshoot, and safely change UniFi network deployments via Site Manager and local Network APIs.

9|Updated Mar 15, 2026
One-click install
npx skills add https://github.com/ironicbadger/codex-skill-unifi-network-ops --skill unifi-network-ops
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: unifi-network-ops
Source: https://github.com/ironicbadger/codex-skill-unifi-network-ops/tree/main
Command: npx skills add https://github.com/ironicbadger/codex-skill-unifi-network-ops --skill unifi-network-ops

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps you inspect, troubleshoot, and safely change UniFi network deployments without guessing which control plane to use.

Core Features & Use Cases

  • Chooses the right interface for each task, including Site Manager API for cloud-visible inventory and WAN health, local Network API for site-specific work, and browser automation for settings the API does not expose.
  • Supports practical UniFi workflows such as client and device diagnostics, Wi-Fi tuning, VLAN and segmentation review, firewall and VPN checks, and low-risk configuration changes.
  • Guides safe operations by capturing current state first, validating changes after each step, and preserving a rollback path for risky edits.

Quick Start

Ask the skill to inspect your UniFi site, diagnose the issue, and recommend the safest interface before making any change.

Frequently Asked Questions about unifi-network-ops

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I troubleshoot UniFi network firewall and VLAN issues safely?

UniFi network troubleshooting is performed by inspecting VLAN segmentation and firewall rules through the local Network API or browser automation, capturing current state before making changes, and validating configurations with rollback-aware checks.

What is the best way to diagnose UniFi Wi-Fi and client connectivity problems?

Diagnosing UniFi Wi-Fi and client issues involves using the Site Manager API for read-only cloud visibility and local Network API for device-specific diagnostics, allowing you to review inventory health and tune wireless settings.

Can I use the UniFi Site Manager API to check device inventory and WAN health?

Yes, the UniFi Site Manager API provides read-only cloud visibility to inspect device inventory and monitor WAN health across local Cloud Gateway and controller sites without risking configuration changes.

How do I safely change UniFi VPN and network configurations without breaking connectivity?

Safely changing UniFi VPN configurations requires capturing the current state first, applying edits via the appropriate Network API or Debug Console, and using rollback-aware validation checks after each step.

Does UniFi API troubleshooting support local Cloud Gateway controllers?

Yes, UniFi API troubleshooting supports local Cloud Gateway and controller sites by automatically selecting the correct control plane, preferring HTTPS local-hostname connections, and using break-glass SSH workflows when needed.

When should I use the UniFi Debug Console or SSH instead of the Network API?

The UniFi Debug Console or SSH break-glass workflows are used when standard API endpoints cannot expose specific settings, requiring direct browser automation or low-level access for advanced device diagnostics and recovery.