unifi-connect SKILL.md skillA

unifi-connect from t3chnaztea/unifi-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add t3chnaztea/unifi-skills/unifi-connect@git:20260823.fda7e6a

Pins git:20260823.fda7e6a in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
t3chnaztea/unifi-skills
Path
skills/unifi-connect/SKILL.md
Versions recorded
3
Latest version
git:20260823.fda7e6a, committed Aug 23, 2026
First version recorded
Jul 24, 2026
Size
14,035 bytes
Repository stars
44
License
MIT

Use when connecting an agent to a UniFi gateway (UDM Pro, UDM SE, Cloud Gateway) for the first time, or when API calls to one are failing: empty response bodies, curl returning HTTP 000, 401 on a key that works elsewhere, "how do I get a UniFi API key", "SSH is closed on my UDM", "connect to UniFi", "talk to my UniFi controller". Covers minting an API key over the API, which endpoint families accept a key, the cookie-session fallback, the HTTP/2 empty-body trap, the endpoint map, and the…

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# UniFi Connect

The first thing to know: **SSH is usually closed and you do not need it.** UniFi
OS exposes a full REST API on the same host as the web UI, and everything these
skills do goes through it. The second thing: **UniFi has three overlapping API
surfaces with different auth rules**, and picking the wrong one produces errors
that look like broken credentials when they are not.

Throughout, `<UDM_HOST>` is your gateway's LAN address. Never hardcode it into a
file you might share.

## Lane 1: API key (use this)

API keys are the modern lane. No login round-trip, no cookie jar, no CSRF token,
and they sidestep the HTTP/2 bug described below.

### Minting a key over the API

The admin UI has a key page, but you do not need it. Keys are mintable from an
authenticated session:

```bash
# Log in once to get a session
curl -sk -X POST "https://<UDM_HOST>/api/auth/login" \
  -H "Content-Type: application/json" \
  -d '{"username":"<ADMIN_USER>","password":"<ADMIN_PASS>"}' \
  -c /tmp/unifi_cookies -D /tmp/unifi_headers

CSRF=$(grep -i 'x-updated-csrf-token' /tmp/unifi_headers | awk '{print $2}' | tr -d '\r')

# Mint a named key
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add t3chnaztea/unifi-skills/unifi-connect@sha256:dd2e51b71898f095

The line at the top of this page pins the label git:20260823.fda7e6a, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_5ueb4vj66ylatguf.svg)](https://markdownregistry.com/a/art_5ueb4vj66ylatguf)

3 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 3 versions of this file, between Jul 24, 2026 and Aug 23, 2026, about one every 15 days.

versioncommittedcommitsizeaudit
git:20260823.fda7e6a latest2026-08-23 fda7e6a 14,035 BA view · diff
git:20260813.ce161b12026-08-13 ce161b1 11,873 BA view · diff
git:20260724.8da6b4d2026-07-24 8da6b4d 10,762 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (14035 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

t3chnaztea/unifi-skills · 44 stars · license MIT · pushed 2026-10-17 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_5ueb4vj66ylatguf
GET https://markdownregistry.com/api/v1/resolve?ref=t3chnaztea/unifi-skills/unifi-connect
GET https://markdownregistry.com/api/v1/blob/dd2e51b71898f0954ac074af6e5f85ecfccc25eee02f5c77ec3441cfaf31e330

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from t3chnaztea/unifi-skills

unifi-clients SKILL.md skill
t3chnaztea/unifi-skills · skills/unifi-clients/SKILL.md · Use when operating on UniFi clients, devices, switch ports, or DHCP: "block a device", "kick a client off wifi"…
git:20260813.a326f4b · audit A · 44 stars
unifi-context-map SKILL.md skill
t3chnaztea/unifi-skills · skills/unifi-context-map/SKILL.md · Use when an agent keeps guessing wrong about a UniFi network, when starting recurring agent work against a gateway, or…
git:20260724.8da6b4d · audit A · 44 stars
unifi-firewall SKILL.md skill
t3chnaztea/unifi-skills · skills/unifi-firewall/SKILL.md · Use when working on UniFi firewall rules, zones, or network segmentation: "my firewall rules are empty"…
git:20260724.8da6b4d · audit A · 44 stars
unifi-wifi SKILL.md skill
t3chnaztea/unifi-skills · skills/unifi-wifi/SKILL.md · Use when UniFi Wi-Fi is slow, unstable, or being tuned: "my wifi is slow but speedtest on the router is fast", "great…
git:20260813.08be721 · audit A · 44 stars
unifi-yourskill SKILL.md skill
t3chnaztea/unifi-skills · template/SKILL.md · Use when [the specific situations, symptoms, and phrases someone would actually type when they hit this problem]…
git:20260724.8da6b4d · audit A · 44 stars

Every file in t3chnaztea/unifi-skills

Browse by kind, by grade A, or by owner.