unifi-network

Query and control UniFi Network devices, clients, firewall, VPN, and routing.

1|Updated Apr 6, 2025
One-click install
npx skills add https://github.com/david-driscoll/stargate-command-cluster --skill unifi-network-david-driscoll
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: unifi-network
Source: https://github.com/david-driscoll/stargate-command-cluster/tree/main/.agents/skills/unifi-network
Command: npx skills add https://github.com/david-driscoll/stargate-command-cluster --skill unifi-network-david-driscoll

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps you safely manage and troubleshoot a UniFi Network environment by turning real network infrastructure questions into targeted controller queries and permission-guarded configuration changes.

Core Features & Use Cases

  • Unified discovery and execution: find the right action via unifi_tool_index, then run it with unifi_execute, or speed up multiple reads with unifi_batch.
  • Operational safety and previews: mutations provide a preview first and require confirmation, with permission gating and clear guidance when policy env vars are needed.
  • End-to-end network management: cover devices, clients, firewall rules, DNS records, port forwarding, QoS, VPN, routing, WLANs, events, and performance statistics.

Quick Start

Use the unifi-network skill to check current network health and identify top bandwidth consumers on your UniFi controller.

Frequently Asked Questions about unifi-network

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

FAQPage Schema
How do I troubleshoot UniFi network connectivity and performance issues?

To troubleshoot UniFi network connectivity, you query devices, clients, and network statistics to identify top bandwidth consumers and check overall network health. The skill enables targeted controller queries for diagnosing performance bottlenecks and connection failures.

Can I manage UniFi firewall policies and VPN configurations programmatically?

Yes, you can manage UniFi firewall policies and VPN configurations through permission-guarded mutations. The skill provides a preview of changes before requiring confirmation, ensuring safe modification of firewall rules, port forwards, and VPN client or server states.

What is the best way to audit changes on a UniFi network controller?

The best way to audit changes on a UniFi network controller is by querying events and alarms. The skill allows you to retrieve historical event logs and active alarms to review recent configuration mutations and network incidents.

How do I configure DNS records and WLANs on a UniFi network?

You configure DNS records and WLANs by discovering the correct actions via a tool index and executing them with permission gating. The skill supports end-to-end network management including routing, DNS, and WiFi WLAN configuration mutations.

Do I need specific permissions to modify port forwarding on UniFi networks?

Yes, modifying port forwarding requires specific permission environment variables. The skill enforces a preview-then-confirm workflow for mutations, ensuring you have explicit policy permissions before applying changes to port forwards or firewall rules.

How do I batch read operations for UniFi network devices and clients?

You batch read operations for UniFi network devices and clients using a dedicated batch execution tool. The skill provides a batching mechanism to run multiple read operations efficiently, speeding up data collection across your network infrastructure.