Communitygithub.com

Genizah

Libera espacio en disco de forma segura en Mac, Windows PC o Linux, paso a paso, con la aprobación del usuario antes de borrar nada y una advertencia adicional antes de eliminar algo importante.

¿Qué es Genizah?

Genizah es una habilidad para agentes de IA diseñada para ayudar a los usuarios a liberar espacio en disco de manera segura y guiada en cualquier sistema operativo: Mac, Windows o Linux. El agente primero identifica el sistema, luego mide el espacio ocupado en ubicaciones seguras (cachés, archivos temporales) y personales (Descargas, Papelera, etc.), y presenta los hallazgos al usuario de forma clara y ordenada. Solo elimina archivos después de obtener la aprobación explícita del usuario para cada elemento, y los archivos personales se envían a la Papelera para permitir su recuperación. La habilidad incluye reglas estrictas como no tocar archivos del sistema, no usar comandos comodín al borrar, y mantener un archivo de historial (`~/.genizah/history.md`) con una lista de "nunca tocar" y un registro de limpiezas anteriores. Es ideal para usuarios de todos los niveles que necesitan una limpieza de disco confiable y sin riesgos, ya sea una limpieza rápida (solo elementos seguros) o una profunda (con revisión elemento por elemento).

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Twistor-Labs/genizah/tree/main/plugins/genizah/skills/genizah

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

¿Qué hace Genizah?

Ayuda al usuario a liberar espacio en disco de forma segura, en cualquier Mac, PC con Windows o máquina Linux. El usuario puede no ser técnico, por lo que todo el trabajo se basa en la confianza: medir primero, explicar en lenguaje sencillo, preguntar antes de tocar algo personal, hacer que cada eliminación personal sea reversible, y reducir la velocidad antes de algo importante.

Cómo hablar y actuar

  • Respuestas cortas, lenguaje sencillo. Di "cachés de aplicaciones (se regeneran solas)", no jerga de carpetas. Muestra las rutas solo junto al nombre simple.
  • Nunca uses derechos de administrador (sudo en Mac/Linux, "Ejecutar como administrador" o PowerShell elevado en Windows) sin preguntar primero y decir por qué.
  • Elimina por ruta exacta, entre comillas. Sin comodines en nada que borre. Un comodín que se expande mal es como las limpiezas destruyen cosas.
  • Pasos pequeños. Después de cada paso, una línea sobre lo que hiciste y cuánto espacio liberaste.

¿Qué computadora es?

Averígualo antes que nada, luego lee la guía correspondiente en references/. Contiene los comandos, ubicaciones de carpetas y trampas específicas del sistema:

ComprobaciónSistemaLeer
uname -s imprime DarwinmacOSreferences/macos.md
uname -s imprime LinuxLinuxreferences/linux.md
uname falla, o $env:OS es Windows_NT en PowerShellWindowsreferences/windows.md

Todo lo siguiente aplica en todos los sistemas. La guía solo proporciona el cómo.

Las reglas que nunca se doblan

Estas aplican para cada solicitud, incluyendo las específicas como "¿mi carpeta de Descargas es grande?":

  1. Cada elemento personal recibe un tamaño y una fecha (última modificación). La fecha es lo que permite al usuario decidir.
  2. Cada elemento personal recibe su propio "sí". "Sí a todo" cubre solo los elementos mostrados en ese mensaje.
  3. Los elementos personales van a la Papelera, nunca a una eliminación permanente. El usuario debe poder cambiar de opinión.
  4. Nunca toques nada en la lista de "nunca tocar" del usuario, incluso si parece basura. Si algo en ella es enorme, menciona el tamaño una vez, luego déjalo.

Si lo que el usuario preguntó resulta pequeño, verifica si se refería a otra carpeta con el mismo nombre. Di claramente lo que encontraste, aún muestra su contenido bajo estas reglas, luego señala los espacios más grandes del resumen. No dejes las reglas porque la conversación avanzó.

0. Memoria y configuración inicial

Genizah mantiene un pequeño archivo de notas en ~/.genizah/history.md (en Windows, %USERPROFILE%\.genizah\history.md). Vive en la carpeta de inicio, no junto a esta habilidad, porque las carpetas de habilidades se reemplazan al actualizar.

Si el archivo existe, léelo primero. Contiene la lista de "nunca tocar" y lo que se limpió antes. Saluda brevemente ("Bienvenido de nuevo. La última vez liberamos 10 GB el 11 de noviembre.", o solo "Bienvenido de nuevo." si aún no hay limpieza registrada), luego ve al paso 1.

Si no existe, este es un usuario nuevo. Aún no saben lo que tocarás, así que una breve bienvenida construye la confianza de la que depende el resto. Un mensaje, de menos de 150 palabras antes de las preguntas:

  1. Qué sucede: primero miras y no borras nada hasta que ellos digan que sí. Todo se clasifica en Seguro (se regenera solo), Consultar contigo (personal, va a la Papelera para que se pueda recuperar), y No tocar (archivos del sistema y lo que nombren ahora).
  2. Los elementos importantes reciben una advertencia: si dicen que sí a algo que importa, como fotos, proyectos o vaciar la Papelera, harás una pausa y les explicarías lo que perderían antes de hacerlo.
  3. Su parte: lean cada lista antes de decir que sí. Pueden detenerse en cualquier momento.
  4. Copia de seguridad: una copia de seguridad antes de una limpieza es inteligente (Time Machine en Mac, Copia de seguridad de Windows o Historial de archivos en Windows, Timeshift o Déjà Dup en Linux). Verificarás si existe una.
  5. Tres preguntas, en el mismo mensaje:
    • "¿Hay algo que nunca deba tocar? Carpetas, aplicaciones o tipos de archivos (por ejemplo, 'mi carpeta de Proyectos', 'todo lo de WhatsApp', 'todos los videos')."
    • "¿Limpieza rápida (solo elementos seguros, unos 5 minutos) o limpieza profunda (todo, incluidos archivos personales que revisas uno por uno)?"
    • "¿Te gustaría ver todo lo que planeo mirar antes de empezar?"

No ejecutes nada aún más allá de la verificación del sistema anterior: espera sus respuestas. Luego crea el archivo de notas:

## Nunca tocar
- <cada cosa que nombraron, como ruta exacta si es posible, o "ninguno">

## Limpiezas

Si nombraron un tipo en lugar de una carpeta ("todos los videos"), escríbelo como lo dijeron y aplícalo como filtro. Si agregan algo después en cualquier sesión, agrégalo a ## Nunca tocar de inmediato y confírmalo en una línea.

Si pidieron ver todo primero, mide (paso 2) y muestra la lista numerada completa de lo que mirarías, agrupada, para que puedan tachar elementos antes de que suceda algo. Agrega lo que tachen a la lista de "nunca tocar" solo si dicen "nunca"; de lo contrario, omítelo solo para esta sesión.

1. Comenzar

  1. Rápida o profunda (omite si ya se respondió, o si la solicitud nombra carpetas específicas: entonces mide esas, más el resumen si resultan pequeñas).
  2. Espacio libre: verifícalo con el comando de la guía y dilo en lenguaje sencillo ("32 GB libres de 460 GB").
  3. Copia de seguridad: verifica con el método de la guía y traduce la respuesta: reciente (bien), antigua (advertir), ninguna configurada (advertir claramente), no se pudo comprobar (pregunta cuándo fue la última copia). Sin copia de seguridad reciente, los cachés seguros aún están bien. Los elementos personales son el riesgo, así que sugiere hacer una copia antes de cualquiera de esos, y pregunta si quieren continuar.

2. Medir

Usa el comando de medición de la guía con su límite de 2 minutos, una carpeta por comando, para que una carpeta lenta no detenga el resto. Sin salida significa que alcanzó el límite: di que lo saltaste y continúa. Un tamaño más errores de "permiso denegado" es un conteo parcial: di "al menos" ese tamaño. Omite cualquier cosa de menos de aproximadamente 100 MB.

  • Limpieza rápida: solo las ubicaciones SEGURAS en la guía.
  • Limpieza profunda, o una pregunta específica que resultó pequeña: ejecuta la lista de resumen de la guía primero para ver dónde está realmente el espacio, luego profundiza un nivel solo en las carpetas grandes.
  • Archivos grandes: usa la búsqueda rápida de la guía, nunca un rastreo completo de la carpeta de inicio.

Antes de llamar "abandonados" a los datos de una aplicación, confirma que la aplicación realmente se ha ido y mira la fecha: datos modificados en el último mes significan que la aplicación aún está en uso. Cuando no estés seguro, es CONSULTAR.

Antes de limpiar el caché de una aplicación, verifica si la aplicación se está ejecutando. Si es así, dilo en la propia lista SEGURA ("Caché de Chrome 4.1 GB, cierra Chrome primero o lo omitiré") para que el único "sí" siga siendo un solo sí.

3. Clasificar y preguntar

Clasifica los hallazgos en tres grupos, del más grande al más pequeño:

  • SEGURO: cachés, registros, archivos temporales. Cosas que se regeneran solas.
  • CONSULTAR: cualquier cosa personal o poco clara. Una fila por elemento con tamaño y fecha. Marca los importantes con ⚠️ (ver más abajo).
  • NO TOCAR: archivos del sistema, la lista de "nunca tocar" y la lista de "no tocar" de la guía. Menciona los grandes para que el usuario sepa que fueron vistos.

Muestra la lista SEGURO completa como una tabla con tamaños y un total, luego espera un "sí".

Luego recorre CONSULTAR un grupo a la vez (Papelera, luego Descargas, luego copias de seguridad del teléfono, etc.), cada elemento con su propio "sí". Un muro de tablas de una vez abruma a la gente. Da una vista previa de una línea de los grupos que vienen. En esa vista previa, di una vez que los elementos personales van a la Papelera, para que se puedan recuperar.

4. Elementos importantes: pausa y advertencia

Algunas cosas duele perderlas. Cuando el usuario dice que sí a una de estas, no actúes en ese primer sí. Detente y da una breve advertencia, luego espera una segunda confirmación específica.

Importante significa cualquiera de:

  • Fotos, videos, música, documentos o cualquier cosa que parezca su propio trabajo (proyectos, exportaciones, borradores, código fuente que no sea una carpeta de compilación regenerable)
  • Cualquier cosa modificada en los últimos 30 días
  • Copias de seguridad del teléfono, especialmente la única o la más reciente
  • Vaciar la Papelera (permanente)
  • Medios de aplicaciones de chat, archivos de contraseñas o claves, volúmenes de bases de datos (volúmenes de Docker, bases de datos locales)
  • Cualquier cosa de más de 5 GB que no sea un caché
  • Cualquier elemento personal cuando no hay una copia de seguridad reciente

La advertencia, con esta forma:

⚠️ Antes de hacer esto: [elemento] ([tamaño], última modificación [fecha]).

  • Lo que perderías: [palabras sencillas, ej. "la única copia de seguridad de tu iPhone de marzo"].
  • ¿Puede volver? [ej. "Sí, desde la Papelera hasta que la vacíes" / "No, vaciar la Papelera es permanente"].
  • Copia de seguridad: [ej. "No tienes una copia de seguridad, así que esto no se puede recuperar."]

Escribe "sí, [nombre corto del elemento]" para continuar, o "saltar".

Di "permanente" o "no se puede deshacer" una vez en la advertencia, no en cada línea a su alrededor.

Un simple "sí" o "vale" después de la advertencia no es suficiente para acciones permanentes (vaciar la Papelera, eliminar volúmenes de bases de datos): pide el nombre del elemento. Para acciones reversibles (mover a la Papelera), un "sí" claro después de la advertencia está bien. Si dicen saltar, continúa sin comentarios. Nunca los discutas dos veces: una advertencia clara, luego respeta su decisión.

5. Eliminar de forma segura

Usa los comandos de la guía:

  • Los elementos SEGUROS se eliminan definitivamente. Prefiere el comando de limpieza propio de una herramienta (npm, pip, brew, docker, etc.) cuando la herramienta esté instalada, porque conoce su propia estructura. Para carpetas de caché simples, vacía la carpeta pero mantén la carpeta en sí.
  • Los elementos CONSULTAR van a la Papelera de forma que permita "Recuperar" o "Restaurar", una ruta exacta a la vez.
  • Vaciar la Papelera siempre es su propia pregunta, con la advertencia ⚠️. Muestra primero los elementos más grandes dentro con fechas: la gente tira cosas por error.
  • Los archivos que se niegan a eliminar porque el sistema los protege: omítelos, no escales a derechos de administrador. Los archivos que se niegan solo porque son de solo lectura y propiedad del usuario pueden hacerse escribibles y eliminarse.

Después de cualquier movimiento a la Papelera, recuerda al usuario que el espacio solo se recupera una vez que se vacía la Papelera.

6. Finalizar

Verifica el espacio libre nuevamente, luego muestra:

Espacio libre antes...
Espacio libre después...
Limpiadocada elemento con su tamaño
Omitido (app abierta, o dijiste que no)...
En la Papelera, esperándote...

Luego 2-3 consejos seleccionados para lo que realmente encontraste (la guía tiene consejos específicos del sistema).

Agrega una entrada de 1-2 líneas en la sección ## Limpiezas del archivo de notas: fecha, espacio libre antes y después, lo que se limpió, lo que se omitió y por qué. Deja ## Nunca tocar intacto.

Nunca eliminar sin preguntar

  • Fotos, videos, música, documentos y proyectos exportados
  • Capturas de pantalla y grabaciones de pantalla de los últimos 30 días
  • Cualquier cosa en Escritorio, Documentos, Descargas, Imágenes, Películas/Videos o Música, a menos que el usuario haya dicho que sí a ese elemento exacto

Nunca tocar, en ningún sistema

  • Carpetas del sistema operativo, instantáneas del sistema y puntos de restauración, archivos de arranque
  • Perfiles del navegador (inicios de sesión, contraseñas, historial). Solo las subcarpetas de caché son válidas
  • Carpetas de sincronización en la nube (iCloud Drive, OneDrive, Dropbox, Google Drive): eliminar allí elimina en todas partes
  • Bibliotecas de fotos y carpetas de aplicaciones de mensajería (limpia los medios desde dentro de la aplicación en su lugar)
  • Imágenes de disco de máquinas virtuales y contenedores
  • Carpetas de claves del administrador de contraseñas, SSH y GPG

Skills relacionados