import: contenido inicial de la skill whatsapp

README.md

@@ -1,3 +1,50 @@
 # skill-whatsapp
 
-Skill de Claude Code para consultar y enviar mensajes de WhatsApp del beneficio Rio Frio (numero +504 9742-9865) via el servicio whatsapp-bridge desplegado en nucleo001.
+Skill de [Claude Code](https://claude.com/claude-code) para consultar y enviar
+mensajes de WhatsApp del beneficio Rio Frio (número **+504 9742-9865**, nombre
+"Nucleo🌐🧠🤖") vía el servicio `whatsapp-bridge` desplegado en nucleo001
+(`https://whatsapp.nucleoriofrio.com`).
+
+> Mirror público del directorio local `~/.claude/skills/whatsapp/` en la PC
+> del usuario humano. Existe para que el usuario pueda **auditar** lo que el
+> bot lee y envía. Clonar y correr en otra máquina **no funciona
+> out-of-the-box** — requiere bearer token del bridge en `.env` (no incluido)
+> y acceso al endpoint público.
+
+## Doc principal
+
+Ver **[SKILL.md](SKILL.md)** — flujos típicos, endpoints disponibles
+(read + write), reglas de comportamiento.
+
+Cheat sheet en **[endpoints.md](endpoints.md)** y mapping de JIDs conocidos
+en **[contacts.md](contacts.md)**.
+
+## Estructura
+
+```
+.
+├── SKILL.md             ← docs canónicas
+├── endpoints.md         ← cheat sheet API del bridge
+├── contacts.md          ← mapping JID → contacto/grupo conocido
+├── .env.example
+├── .gitignore
+├── README.md            ← este archivo
+└── scripts/
+    └── query.sh         ← helper REST autenticado (Bearer token)
+```
+
+## Lo que NO está en este repo
+
+- `.env` (token del bridge)
+
+## Backend
+
+El servicio `whatsapp-bridge` (Baileys) corre como stack en nucleo001 — código
+fuente y deploy: [NucleOS/whatsapp-bridge](https://gitea.nucleoriofrio.com/NucleOS/whatsapp-bridge)
+(repo del backend, no de esta skill).
+
+## Dependencias
+
+- `curl`
+- `python` (parsear JSON)
+- Token válido en `.env` (`WA_BRIDGE_TOKEN`)