Claude Code · skill oficial

Tus notas, desde la terminal.

Una skill para Claude Code que abre tu baúl cifrado en tu propio equipo. Le pides lo que quieras en lenguaje natural y él busca, resume, crea o reordena tus notas. Sin dependencias, sin servidor y con tu contraseña maestra guardada por Windows —no por el modelo.

Windows · 10 u 11 Node · 18+ 0 dependencias 13 archivos

Lo que le puedes pedir

>

«¿Qué apunté sobre el proveedor de tinta?» — busca en todo el baúl, sin acentos y tolerando erratas.

>

«Resume mis notas de las juntas de este mes» — lee solo las que hagan falta.

>

«Crea una nota en Trabajo con la lista de pendientes de hoy» — con sus bloques y etiquetas.

>

«Enlaza esta nota con el manual del server» — entiende los enlaces [[…]] y las secciones.

>

«Sincroniza con Drive» — fusión de tres vías: si editaste aquí y allá, no se pisa nada.

>

«Archiva lo de 2025» — archivar es reversible; borrar te lo va a preguntar.

Instalar

1
Una línea en tu terminal

Pégala en PowerShell. Deja dos cosas: el comando suzuri en cualquier terminal, y la skill donde Claude Code la ve en todos tus proyectos —no hay que instalarla proyecto a proyecto.

PowerShell
irm https://suzuri.app/install.ps1 | iex

No instala Node (si falta, te lo dice y para), no pide administrador y solo toca el PATH de tu usuario. Puedes leerlo antes de ejecutarlo: está abajo, en Los archivos, uno por uno.

2
Dile dónde está tu baúl

La ruta de tu archivo .suzuri la tienes en la app: Ajustes → Baúl → Ubicación. Cópiala de ahí.

una sola vez
suzuri use "C:\ruta\a\mis-notas.suzuri"
3
Tu contraseña la tecleas tú

Este paso es a mano a propósito: se teclea con eco oculto, se verifica contra el baúl y va directa al Administrador de credenciales de Windows. Nunca la escribas en el chat, ni a Claude ni a nadie.

una sola vez
suzuri set-password
suzuri status
4
Listo: háblale en tu idioma

«¿Qué apunté sobre el proveedor de tinta?», «resume mis notas de las juntas de este mes», «crea una nota en Trabajo con los pendientes de hoy». Él sabe cuándo usar la skill. Y tú tienes el comando: suzuri tree, suzuri search "tinta".

Prefiero que lo instale Claude, solo en un proyecto

Sin comando global y sin tocar el PATH: los archivos quedan dentro de .claude/skills/ de ese proyecto. Abre Claude Code ahí y pégale esto.

pégalo en Claude Code
Instala la skill de Suzuri siguiendo las instrucciones de
https://suzuri.app/skill/INSTALL.md
Prefiero hacerlo a mano

Necesitas Node 18 o superior. Este bloque crea la carpeta y baja los archivos; no ejecuta nada de lo descargado.

PowerShell · en la raíz de tu proyecto
[Net.ServicePointManager]::SecurityProtocol = 'Tls12'
$base = "https://suzuri.app/skill"
$dest = ".claude/skills/suzuri-vault"
$files = @(
  "SKILL.md",
  "INSTALL.md",
  "bin/vault.mjs",
  "bin/lib/blocks.mjs",
  "bin/lib/config.mjs",
  "bin/lib/crypto.mjs",
  "bin/lib/diff3.mjs",
  "bin/lib/gdrive.mjs",
  "bin/lib/merge.mjs",
  "bin/lib/secrets.mjs",
  "bin/lib/vaultfile.mjs",
  "reference/google-setup.md",
  "reference/note-format.md"
)
foreach ($f in $files) {
  $out = Join-Path $dest $f
  New-Item -ItemType Directory -Force -Path (Split-Path $out) | Out-Null
  Invoke-WebRequest -Uri "$base/$f" -OutFile $out -UseBasicParsing
  Write-Host "  ok  $f"
}
PowerShell · apuntar y guardar la contraseña
node .claude/skills/suzuri-vault/bin/vault.mjs use "C:\ruta\a\mis-notas.suzuri"
node .claude/skills/suzuri-vault/bin/vault.mjs set-password
node .claude/skills/suzuri-vault/bin/vault.mjs status

Google Drive es opcional. Si quieres sincronizar, la guía está dentro de la propia skill, en reference/google-setup.md.

Los archivos, uno por uno

install.ps1El instalador de una línea — el que se ejecuta en tu equipo156 líneas
SKILL.mdLas instrucciones que lee Claude251 líneas
INSTALL.mdEl guion de instalación que sigue Claude77 líneas
bin/vault.mjsEl CLI: todos los comandos1350 líneas
bin/lib/crypto.mjsPBKDF2 + AES-256-GCM, igual que el navegador69 líneas
bin/lib/secrets.mjsAlmacén de credenciales de Windows (DPAPI de respaldo)179 líneas
bin/lib/vaultfile.mjsLectura y escritura del archivo .suzuri145 líneas
bin/lib/blocks.mjsEl formato de bloques de una nota404 líneas
bin/lib/merge.mjsFusión de tres vías (sin perder datos)373 líneas
bin/lib/diff3.mjsEl diff a tres bandas que usa la fusión151 líneas
bin/lib/gdrive.mjsOAuth y subida/bajada de Drive (opcional)248 líneas
bin/lib/config.mjsRutas y preferencias locales41 líneas
reference/note-format.mdCómo se escribe el contenido de una nota139 líneas
reference/google-setup.mdCómo conectar Google Drive91 líneas

Toca un nombre y se abre aquí mismo, sin descargar nada. Son los mismos archivos que usa el autor, publicados desde el repositorio con un script (tools/sync-skill.mjs) que copia la skill tal cual: lo que lees es byte por byte lo que corre en su equipo. Puedes revisarlo antes de instalar nada.

Qué ve el modelo y qué no

Dicho sin letra chica
  • La contraseña maestra no sale de tu equipo. La lee el programa del almacén de credenciales de Windows para descifrar en memoria; no viaja al modelo, ni a un archivo, ni al historial de comandos.
  • El texto de las notas que pides sí llega al modelo. Es lo que le permite responder. Tú eliges qué nota.
  • Las claves guardadas van censuradas salvo que las pidas en ese momento.
  • Borrar es irreversible y exige --yes; archivar no. La skill te ofrecerá archivar primero.

La versión larga, con el detalle criptográfico, está en Seguridad → Desde la terminal.

Cómo protege tus datos Abrir Suzuri