import: contenido inicial de la skill bitwarden

README.md

@@ -1,3 +1,43 @@
 # skill-bitwarden
 
-Skill local de Claude Code para acceder a la cuenta claudecode0 en el Vaultwarden self-hosted del beneficio Rio Frio (vault.nucleoriofrio.com). Read+create vía bw serve local, con guard server-side+script-side.
+Skill local de [Claude Code](https://claude.com/claude-code) para acceder a la
+cuenta `claudecode0` en el Vaultwarden self-hosted del beneficio Rio Frio
+(`vault.nucleoriofrio.com`). Read+create vía `bw serve` local, con guards
+server-side + script-side.
+
+> Este repo es un mirror público del directorio local de la skill que vive
+> en `~/.claude/skills/bitwarden/` en la máquina del usuario humano. Existe
+> para que el usuario humano pueda **auditar** lo que el bot hace en su
+> cuenta. Clonar y correr en otra máquina **no funciona out-of-the-box** —
+> requiere `bw` CLI configurado, master password en `.env` (no incluido), y
+> los paths absolutos del setup.
+
+## Doc principal
+
+Ver **[SKILL.md](SKILL.md)** — diseño, modelo de seguridad, lifecycle,
+endpoints. Es la fuente de verdad.
+
+Cheat sheet de endpoints en **[endpoints.md](endpoints.md)**.
+
+## Estructura
+
+```
+.
+├── SKILL.md             ← docs canónicas
+├── endpoints.md         ← cheat sheet de bw serve REST API
+├── .env.example         ← plantilla de config
+├── .gitignore
+├── README.md            ← este archivo
+└── scripts/
+    ├── setup.sh         ← one-time/recovery (config server + login + unlock)
+    ├── serve-up.sh      ← lanzar bw serve (idempotente)
+    ├── serve-down.sh    ← parar bw serve
+    └── query.sh         ← helper REST con read+create guard
+```
+
+## Lo que NO está en este repo
+
+- `.env` (master password, API keys del bot)
+- `.cache/` (session tokens, PIDs, vault encriptado local de bw)
+
+Esos viven solo en la PC del usuario humano.