Communitygithub.com

asset-diet

Auditez, compressez, dédupliquez et restaurez les fichiers médias d'un dépôt local (PNG/JPG/WebP/AVIF via Sharp, SVG via SVGO, MP4/WebM via FFmpeg, GLB/GLTF 3D via glTF-Transform) à la demande via `npx [email protected]` CLI sans surcharge MCP permanente. Déclenchez UNIQUEMENT lorsque l'utilisateur demande explicitement d'auditer, compresser, dédupliquer ou réduire la taille des images, SVG, vidéos ou modèles 3D.

Qu'est-ce que asset-diet ?

AssetDiet est une compétence pour agent IA qui permet d'auditer, compresser, dédupliquer et restaurer des médias locaux (images, SVG, vidéos, modèles 3D) directement depuis la CLI via `npx [email protected]`. Il fonctionne en mode éphémère et 100% local — aucun fichier n'est téléchargé vers le cloud et aucun serveur MCP permanent n'est installé dans la session de chat, évitant ainsi le gonflement de schéma des 16 outils MCP. La compétence s'appuie sur des outils reconnus (Sharp pour les images, SVGO pour les SVG, FFmpeg pour les vidéos, glTF-Transform pour les modèles 3D) et offre un workflow en trois étapes : audit en lecture seule (sans modification), optimisation avec politique de sécurité et sauvegarde atomique, puis restauration instantanée par ID de run et nettoyage Git. Les politiques de compression incluent `safe` (par défaut, perte minimale, même extension, déduplication sécurisée), `balanced` (conversion WebP avec migration des références dans le code source — à confirmer par l'utilisateur) et des options pour les fichiers purement web. La compétence protège les icônes d'applications natives dans les projets Expo/React Native en conservant les extensions .png. Des garde-fous stricts empêchent l'enregistrement du serveur MCP et imposent l'audit avant toute écriture, avec conservation de l'extension exacte et suppression des doublons uniquement lorsqu'ils n'ont aucune référence dans le code. Le dossier de sauvegarde .assetdiet/ ne doit jamais être commité.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

AssetDiet (Audit et compression locale de médias à la demande)

Utilisez 092Abdullah/AssetDiet (npm: assetdiet-mcp) strictement comme un CLI local éphémère et 100 % local via npx [email protected] — aucun transfert vers le cloud et zéro gonflement permanent de schéma 16 outils MCP dans les sessions de chat.

1. Garde-fous non négociables

  1. N'enregistrez JAMAIS le serveur MCP : N'exécutez jamais assetdiet setup ou assetdiet mcp. Invoquez toujours les sous-commandes CLI directement (audit, scan, optimize, restore, doctor).
  2. Épinglez la version auditée ([email protected]) : Évitez @latest non épinglé dans les exécutions automatisées pour que le comportement de la chaîne d'approvisionnement corresponde à la version auditée.
  3. Audit en lecture seule avant les écritures : Exécutez toujours audit d'abord et affichez les économies potentielles + les groupes de doublons avant de modifier les ressources du dépôt (sauf si l'utilisateur a explicitement demandé d'appliquer --policy safe immédiatement).
  4. Protection des icônes d'application Expo / React Native : Dans les projets Expo / React Native (app.json / app.config.ts), les icônes natives de l'application, les écrans de démarrage, les icônes de notification et les ressources require('./foo.png') statiques nécessitent souvent l'extension .png — conservez --policy safe (même extension, sans perte/SSIM ≥ 0.98) sauf si vous ciblez un dossier purement web (public/, static/) avec approbation explicite de l'utilisateur pour la conversion en .webp.

2. Workflow étape par étape

Étape 1 : Audit en lecture seule (aucune modification de fichier)

# Résumé rapide sur 3 lignes (taille totale, économies, groupes de doublons SHA-256)
npx [email protected] audit <cheminCible> --policy safe --summary

# Détail complet par fichier (ou ajouter --json pour un filtrage structuré)
npx [email protected] audit <cheminCible> --policy safe

Étape 2 : Optimisation sécurisée avec journal atomique et sauvegarde

  • Politique safe (Par défaut — Recommandée) : Compresse sur place (Sharp sans perte / 85, SVGO en conservant viewBox), conserve les extensions exactes des fichiers, ne touche jamais aux importations du code source, et supprime les copies en octets en double uniquement lorsqu'elles n'ont aucune référence de code :
    # Aperçu facultatif en mode dry-run
    npx [email protected] optimize <cheminCible> --policy safe --dry-run
    
    # Exécution avec sauvegarde atomique (.assetdiet/backups/<runId>/)
    npx [email protected] optimize <cheminCible> --policy safe
    
  • Politique balanced (Web uniquement .png/.jpg → .webp + migration des références de code — demander confirmation d'abord) :
    npx [email protected] optimize <cheminCible> --policy balanced --dry-run
    npx [email protected] optimize <cheminCible> --policy balanced
    
    Après balanced, inspectez immédiatement git status et git diff sur tous les fichiers .ts/.tsx/.jsx/.css/.html modifiés et exécutez la compilation/vérification de type du projet.

Étape 3 : Restauration instantanée et hygiène Git de .assetdiet/

  1. Enregistrez l'ID de run affiché par optimize. Si une ressource semble dégradée ou qu'une importation se casse, restaurez les originaux octet par octet en une commande :
    npx [email protected] restore --run <runId> --path <cheminCible>
    
  2. Ne commitez jamais les sauvegardes .assetdiet/ dans Git : Assurez-vous que .assetdiet/ est listé dans .gitignore (ou supprimez .assetdiet/ une fois que la vérification visuelle/de compilation est réussie et que l'utilisateur confirme).

Skills associés