import: contenido inicial de la skill unifi

README.md

@@ -1,3 +1,45 @@
 # skill-unifi
 
-Skill local read-only de Claude Code para diagnosticar el UDM Pro del beneficio Rio Frio (192.168.87.5) via Integration API + Classic API. Solo accesible desde la LAN.
+Skill local read-only de [Claude Code](https://claude.com/claude-code) para
+diagnosticar el **UDM Pro** del beneficio Rio Frio (`192.168.87.5`) vía la
+Integration API oficial de UniFi Network y la Classic API (cookie + CSRF).
+
+> Mirror público del directorio local `~/.claude/skills/unifi/` en la PC del
+> usuario humano. Existe para que el usuario pueda **auditar** lo que el bot
+> hace contra el UDM. Clonar y correr en otra máquina **no funciona
+> out-of-the-box** — requiere API key del UDM en `.env` (no incluido) y estar
+> en la LAN del beneficio (192.168.87.0/24).
+
+## Doc principal
+
+Ver **[SKILL.md](SKILL.md)** — diseño, modelo de seguridad (read-only por
+rol del bot + script guard), flujos típicos de diagnóstico.
+
+Cheat sheet en **[endpoints.md](endpoints.md)** y mapa de
+MACs/IPs → equipos en **[topology.md](topology.md)**.
+
+## Estructura
+
+```
+.
+├── SKILL.md             ← docs canónicas
+├── endpoints.md         ← cheat sheet Integration + Classic API
+├── topology.md          ← mapa MAC/IP → equipo/facility
+├── .env.example
+├── .gitignore
+├── README.md            ← este archivo
+└── scripts/
+    ├── query.sh         ← wrapper Integration API (X-API-KEY)
+    └── query-classic.sh ← wrapper Classic API (cookie + CSRF, cache 25 min)
+```
+
+## Lo que NO está en este repo
+
+- `.env` (API key del UDM)
+- `.cache/` (cookies de session de la Classic API)
+
+## Dependencias
+
+- `curl`
+- `jq` (recomendado) o `python` para filtrar JSON
+- LAN del beneficio (192.168.87.0/24) para alcanzar `192.168.87.5`