---
name: UniFi Yourskill
slug: unifi-yourskill
category: Automation
description: Use when you need help diagnosing a UniFi network issue described as slow Wi‑Fi, clients dropping, VLAN or firewall confusion, or other symptoms that fit the sibling skills. Not for firewall rules, Wi‑Fi tuning, client issues, or context mapping; use the matching UniFi sibling skill.
github: "https://github.com/t3chnaztea/unifi-skills/tree/main/template"
language: Python
stars: 33
forks: 1
install: "npx degit https://github.com/t3chnaztea/unifi-skills/tree/main/template ~/.claude/skills/template"
installs_to: ~/.claude/skills/template
source_path: template/SKILL.md
collection_size: 6
category_size: 1523
collection_url: "https://dirskills.com/collections/t3chnaztea/unifi-skills"
added: 2026-08-11T07:21:50.717Z
last_synced: 2026-08-11T07:21:50.717Z
canonical_url: "https://dirskills.com/skills/unifi-yourskill"
---

# UniFi Yourskill

Use when you need help diagnosing a UniFi network issue described as slow Wi‑Fi, clients dropping, VLAN or firewall confusion, or other symptoms that fit the sibling skills. Not for firewall rules, Wi‑Fi tuning, client issues, or context mapping; use the matching UniFi sibling skill.

**Install:**

```bash
npx degit https://github.com/t3chnaztea/unifi-skills/tree/main/template ~/.claude/skills/template
```

## README

# UniFi Yourskill

One or two sentences: what this covers, and that it assumes the auth lanes and
endpoint map from `unifi-connect`. Cross-reference siblings by name
(`unifi-firewall`, `unifi-wifi`, `unifi-clients`, `unifi-context-map`) instead
of repeating their content.

## Guidelines for a good UniFi skill

Delete this section in your real skill; it is authoring guidance.

- **Name:** `unifi-<area>`, lowercase and hyphens. The directory name MUST equal
  the frontmatter `name`.
- **Description:** starts with "Use when", lists concrete triggers and symptom
  phrasings, ends with a "not for X, use Y" pointer. No workflow summary: an
  agent will follow the description instead of reading the body.
- **Parameterize everything site-specific.** `<UDM_HOST>` never a real address,
  `$UNIFI_API_KEY` from env never a literal, `<DEVICE_ID>` / `<ZONE_ID>` /
  `<MAC>` placeholders. Where an example address is unavoidable use the
  documentation ranges: `192.0.2.x` (RFC 5737) and `aa:bb:cc:dd:ee:ff`.
- **Never include a real inventory.** No MAC lists, no camera names or
  placements, no WAN address, no SSID names, no household or company names. See
  `unifi-context-map` for why this matters more here than in most repos.
- **Original prose only.** Do not paste from Ubiquiti docs or help-centre
  articles. Write the lesson the docs do not teach, and link the docs as the
  canonical manual.
- **Say which version you verified against**, in `compatibility` and in the body
  for any version-sensitive claim. UniFi moves endpoints between releases with
  no deprecation notice. A claim stated as universal that was observed once on
  one controller is the most likely thing in a skill to be wrong.
- **Distinguish config from operational state.** This API will echo back
  settings it has not applied. If a claim rests on a read-back, say which field
  and which endpoint proves it.
- **Verify against ground truth.** Every write ends with a fresh read and a
  before/after. Show the reader how to confirm, not just how to change.
- Keep `SKILL.md` under ~500 lines; push heavy detail into `references/*.md`.
- Scripts are allowed here (this repo ships one) but keep them standard-library
  only, dependency-free, and readable in one sitting. An agent operating
  someone's gateway should be running code they can audit in five minutes.

## Overview

What this is and the core principle, in one or two sentences.

## When to use

Symptoms and situations. When NOT to use.

## [Your sections]

Quick-reference recipes, one worked example, the specific traps you learned. One
excellent example beats five generic ones. If you have a postmortem, tell it:
the numbers and the wrong turns are what make it stick.