unifi-context-map

Solid

Use when an agent keeps guessing wrong about a UniFi network, when starting recurring agent work against a gateway, or when asked to "map my network", "document my UniFi setup", "build a network inventory", "what's on my network", "why does the agent keep using the wrong AP", or "audit my reservations against reality". Covers writing and maintaining the site map file: networks, devices, SSIDs, reservations, zones, an append-only Gotchas list, provenance checks that keep it honest, and the security rules for a file that is a burglary aid if it leaks. Assumes unifi-connect. Not for making changes to any of it (unifi-firewall, unifi-wifi, unifi-clients).

Data & Documents 30 stars 1 forks Updated 2 days ago MIT

Install

View on GitHub

Quality Score: 85/100

Stars 20%
50
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
80
License 10%
100
Description 5%
100

Skill Content

# UniFi Context Map This repo deliberately ships no network inventory, because the useful one is yours. This skill is how the agent builds it. An agent working a UniFi network without a map guesses: which AP is the one in the back bedroom, whether `10.x.x.50` is the NAS or a decommissioned print server, whether that camera reservation reflects where the camera actually is. UniFi answers with MAC addresses and machine names, and it is confidently wrong in a specific way: **the config is not the operational reality.** A reservation exists whether or not the device honors it. A port override is stored whether or not the hardware enforces it. One markdown file, one human pass, fixes this. ## Read this before you write anything down **A complete UniFi map is a burglary aid.** Not being dramatic: assembled in one file it contains camera names and their physical placements, which cameras are on which segment, your WAN address, the MAC address of every device in the building, your alarm panel's IP, and which SSID is the trusted one. That is a casing document with a network diagram attached. So, before the first line: - **Never commit it to a public repo.** Not "scrub it later". Git history is forever and the scrub is always harder than you think. - **`.gitignore` it by name** in whatever repo you do network work from. A suggested pattern is in this repo's `.gitignore`. - **Never paste it into a shared or third-party context** you do not control. - **The API key never goes ...

Details

Author
t3chnaztea
Repository
t3chnaztea/unifi-skills
Created
3 days ago
Last Updated
2 days ago
Language
Python
License
MIT

Similar Skills

Semantically similar based on skill content — not just same category

AI & Automation Listed

map

Codebase orientation for an unfamiliar or large repo — "map this before I work in it." Fans out read-only Explore sub-agents that navigate the code (keyless — grep/glob/read, no embeddings to go stale) along the order that matters: entry points, build/test/lint commands, architecture and key abstractions, conventions and gotchas, test layout. Distills the findings into a lean AGENTS.md at the repo root — the cross-tool standard file many agents auto-load — where every claim points to a real file and nothing survives that isn't load-bearing. Human-in-the-loop: it drafts, you approve, and it never writes or commits into your repo without an explicit yes. Stamps the map with date + commit so /map refresh regenerates only what went stale. Use before working in a repo you or the agent don't know — e.g. "/map", "/map the auth subsystem", "generate an AGENTS.md", "/map refresh". Run it upstream of feature or bugfix; for the end-of-session shipping gate use done.

7 Updated yesterday
duthaho
API & Backend Solid

unifi-clients

Use when operating on UniFi clients, devices, switch ports, or DHCP: "block a device", "kick a client off wifi", "restart an access point", "power cycle a PoE port", "move a device to a different VLAN", "my device is on the wrong subnet after I changed the port", "set a DHCP reservation", "change DHCP DNS servers", "forget an old client", "why did my PUT reset all the other ports", or reading UniFi events and alarms. Covers full-object PUT discipline, the wired VLAN migration trap, and where events moved. Assumes unifi-connect. Not for firewall policy between zones (unifi-firewall), radios and SSIDs (unifi-wifi).

30 Updated 2 days ago
t3chnaztea
AI & Automation Listed

context-mapper

Pre-execution mapping of codebases, document collections, or problem spaces. Runs BEFORE any Gorgon workflow to give all agents shared situational awareness

4 Updated 5 days ago
AreteDriver