Communitygithub.com

asset-diet

Audita, comprime, deduplica y revierte activos multimedia locales (PNG/JPG/WebP/AVIF con Sharp, SVG con SVGO, MP4/WebM con FFmpeg, 3D GLB/GLTF con glTF-Transform) bajo demanda mediante el CLI `npx [email protected]`, sin sobrecarga permanente de MCP.

¿Qué es asset-diet?

AssetDiet es un experto local en auditoría y compresión de activos multimedia para desarrolladores que trabajan con repositorios que contienen imágenes, vídeos, modelos 3D y archivos SVG. Se ejecuta de forma efímera y 100% local a través de `npx [email protected]`, sin necesidad de instalación permanente ni subidas a la nube, eliminando la sobrecarga de esquemas MCP de 16 herramientas en las sesiones de chat. La herramienta permite escanear y auditar activos multimedia (PNG, JPG, WebP, AVIF, SVG, MP4, WebM, GLB, GLTF), mostrando ahorros potenciales y grupos de duplicados antes de realizar cualquier cambio. Ofrece políticas de optimización: 'safe' (compresión sin pérdida, mantiene extensiones y referencias de código), 'balanced' (conversión web a WebP con migración de referencias) y 'aggressive'. También incluye un sistema de respaldo atómico con reversión instantánea y protector de iconos de aplicaciones nativas para proyectos Expo/React Native. Compatible con todos los entornos Node.js, especialmente útil para equipos que gestionan repos multirepo o monorepo con gran cantidad de activos multimedia.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/TursunboyevJahongir/tasted-skills/tree/HEAD/skills/asset-diet

Preguntar en tu IA favorita

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

Documentación

AssetDiet (Auditoría y Compresión Local de Activos Multimedia Bajo Demanda)

Usa 092Abdullah/AssetDiet (npm: assetdiet-mcp) estrictamente como un CLI local efímero 100% local mediante npx [email protected] — sin subidas a la nube y sin sobrecarga permanente de esquema MCP de 16 herramientas en las sesiones de chat.

1. Reglas No Negociables

  1. NUNCA registres el servidor MCP: No ejecutes assetdiet setup ni assetdiet mcp. Siempre invoca los subcomandos del CLI directamente (audit, scan, optimize, restore, doctor).
  2. Fija la versión auditada ([email protected]): Evita @latest sin fijar en ejecuciones automatizadas para que el comportamiento de la cadena de suministro coincida con la versión auditada.
  3. Auditoría de solo lectura antes de escribir: Ejecuta siempre audit primero y muestra los ahorros potenciales y grupos de duplicados antes de mutar los activos del repositorio (a menos que el usuario haya solicitado explícitamente aplicar --policy safe de inmediato).
  4. Protección de iconos de aplicaciones Expo / React Native: En proyectos Expo / React Native (app.json / app.config.ts), los iconos de aplicaciones nativas, pantallas de inicio, iconos de notificación y activos require('./foo.png') estáticos a menudo requieren extensiones .png — mantén --policy safe (misma extensión, sin pérdida/SSIM ≥ 0.98) a menos que se apunte a una carpeta web pura (public/, static/) con aprobación explícita del usuario para conversión a .webp.

2. Flujo de Trabajo Paso a Paso

Paso 1: Auditoría de Solo Lectura (Sin Cambios en Archivos)

# Resumen rápido de 3 líneas (tamaño total, ahorros, grupos de duplicados SHA-256)
npx [email protected] audit <rutaDestino> --policy safe --summary

# Desglose completo por archivo (o añade --json para filtrado estructurado)
npx [email protected] audit <rutaDestino> --policy safe

Paso 2: Optimizar de Forma Segura con Diario Atómico y Respaldo

  • Política safe (Predeterminada — Recomendada): Comprime en el lugar (Sharp sin pérdida/85, SVGO manteniendo viewBox), conserva las extensiones de archivo exactas, nunca toca las importaciones de código fuente y elimina copias duplicadas de bytes solo cuando tienen 0 referencias de código:
    # Vista previa opcional de simulación
    npx [email protected] optimize <rutaDestino> --policy safe --dry-run
    
    # Ejecutar con respaldo atómico (.assetdiet/backups/<runId>/)
    npx [email protected] optimize <rutaDestino> --policy safe
    
  • Política balanced (Solo web .png/.jpg → .webp + migración de referencias de código — pide confirmación primero):
    npx [email protected] optimize <rutaDestino> --policy balanced --dry-run
    npx [email protected] optimize <rutaDestino> --policy balanced
    
    Después de balanced, inspecciona inmediatamente git status y git diff en todas las importaciones modificadas .ts/.tsx/.jsx/.css/.html y ejecuta la compilación/verificación de tipos del proyecto.

Paso 3: Reversión Instantánea e Higiene de Git de .assetdiet/

  1. Guarda el ID de ejecución impreso por optimize. Si algún activo parece degradado o una importación se rompe, restaura los originales byte por byte en un solo comando:
    npx [email protected] restore --run <idEjecucion> --path <rutaDestino>
    
  2. Nunca subas los respaldos de .assetdiet/ a Git: Asegúrate de que .assetdiet/ esté listado en .gitignore (o elimina .assetdiet/ una vez que la verificación visual/de compilación pase y el usuario lo confirme).

Skills relacionados