AI Agent Skill
Teach AI coding agents to manage your UniFi network
Unifly ships with a dedicated skill bundle that teaches AI coding agents how to manage your UniFi network infrastructure. Your agent gets the full CLI reference, automation workflows, and a ready-made network manager agent.
🔗Install
# Claude Code, Cursor, Copilot, Codex, Gemini, and more
npx skills add hyperb1iss/unifly
# Target a specific agent platform
npx skills add hyperb1iss/unifly -a claude-code
# As a Claude Code plugin
/plugin marketplace add hyperb1iss/unifly
🔗What’s Included
graph TD SKILL["unifly Skill Bundle"] --> REF["Command Reference
27 commands, flags, gotchas"] SKILL --> AGENT["Network Manager Agent
Autonomous provisioning"] SKILL --> CONCEPTS["Networking Concepts
Dual-API architecture, auth"] SKILL --> WORKFLOWS["Workflow Patterns
Automation recipes"] SKILL --> EXAMPLES["Example Payloads
JSON templates for --from-file"] style SKILL fill:#e135ff,color:#0a0a0f style AGENT fill:#50fa7b,color:#0a0a0f
| Component | Description |
|---|---|
| unifly skill | Complete CLI reference with command syntax, flags, output formats, and automation tips |
| Network Manager agent | Autonomous agent for provisioning VLANs, auditing firewalls, diagnosing connectivity |
| Reference docs | UniFi networking concepts, dual-API gate matrix, auth decision tree |
| Workflow patterns | Runnable recipes for event streaming, firewall reordering, DHCP reservations, DNS policies |
| Example payloads | JSON templates for --from-file (networks, firewall, NAT, WiFi) |
🔗What Your Agent Can Do
With the skill installed, your coding agent can:
- Provision infrastructure: Create VLANs, WiFi SSIDs, firewall zones, and isolation policies in the correct dependency order
- Audit security: Check for open WiFi, permissive firewall rules, missing zone isolation
- Diagnose connectivity: Trace device topology, check client signal strength, review event logs
- Manage devices: Restart APs, adopt new devices, check firmware versions
- Query statistics: Pull bandwidth trends, DPI app breakdown, client count history
- Automate workflows: Bulk DHCP reservations, DNS policy management, voucher provisioning
🔗Slash Commands
Two slash commands are included for quick actions:
| Command | Description |
|---|---|
/unifly-status | Quick health check of your UniFi infrastructure |
/unifly-audit | Security audit of WiFi, firewall, and network configuration |
🔗Prerequisite
The agent needs unifly installed and configured on the system where it runs:
# Install unifly
curl -fsSL https://raw.githubusercontent.com/hyperb1iss/unifly/main/install.sh | sh
# Configure a controller profile
unifly config init
The skill teaches the agent to use unifly CLI commands. It does not connect to your controller directly.
🔗Example Prompts
Once the skill is installed, try these with your coding agent:
- “Set up an IoT VLAN on 10.0.30.0/24 with a dedicated WiFi SSID and firewall isolation from the trusted network”
- “Audit my firewall rules for any allow-all policies or missing zone isolation”
- “Find the client named ‘ring-doorbell’ and show me its connection details”
- “Show me the network topology and identify any devices that are offline”
- “Stream events for the next few minutes and flag anything unusual”
The agent will use unifly commands with -o json output, parse the results, and orchestrate multi-step workflows automatically.
🔗Next Steps
- Quick Start: make sure unifly is configured before using the skill
- Authentication: API Key mode is the recommended default on UniFi OS. Hybrid is only needed for WebSocket features like
events watch - CLI Commands: the commands the agent will use under the hood