agency-skills-suite/agency-archivist/README.md
AgentePotente 94642c3501 PORTING: Python → Node.js per agency-archivist scripts
Motivazione:
- Node.js già installato (v25.7.0), zero privilegi necessari
- Nessuna dipendenza npm richiesta (usa built-in modules)
- Tool di sistema per estrazione: unzip, tar, identify (ImageMagick)
- Più gestibile in ambienti senza sudo

Cambiamenti:
- extract_archive.py → extract_archive.js (11.6KB)
  - Usa execSync per unzip/tar/unrar
  - Stessa logica, zero dipendenze esterne

- scan_resources.py → scan_resources.js (13.4KB)
  - Usa ImageMagick identify per metadata immagini
  - ffprobe opzionale per video
  - Genera tag e use case automaticamente

- generate_catalog.py → generate_catalog.js (8.7KB)
  - Stesso output markdown
  - Zero dipendenze

- README.md aggiornato con comandi Node.js
- SKILL.md aggiornato con riferimenti corretti

Dipendenze opzionali (tool di sistema):
- unrar: Supporto archivi RAR
- ffmpeg/ffprobe: Metadata video avanzati
2026-03-10 23:44:14 +01:00

2 KiB

agency-archivist

Gestione archivi di risorse (immagini, video, documenti) per progetti agency.

Installazione

Copia la cartella in ~/.openclaw/skills/ o usa lo script:

cd ~/agency-skills-suite
./INSTALL.sh

Utilizzo

1. Estrazione Archivio

node scripts/extract_archive.js brand_assets.zip --client demo_co_srl
node scripts/extract_archive.js https://example.com/assets.zip --client demo_co_srl

2. Scansione Risorse

node scripts/scan_resources.js --client demo_co_srl --pass 1
node scripts/generate_catalog.js --client demo_co_srl

Struttura

agency-archivist/
├── SKILL.md                 # Istruzioni skill
├── README.md                # Questa guida
├── scripts/
│   ├── extract_archive.js   # Estrazione zip/URL (Node.js)
│   ├── scan_resources.js    # Scansione metadata (Node.js)
│   └── generate_catalog.js  # Generazione catalogo (Node.js)
└── references/
    └── resource_types.md    # Tipologie risorse e use case

Integrazione

Questa skill si integra con:

  • agency-orchestrator — Upload risorse in Fase 1
  • agency-visual-generator — Usa risorse catalogate
  • agency-design-system — Recupera logo e brand assets
  • agency-web-developer — Usa immagini per sito
  • agency-social — Usa immagini per content calendar

Dipendenze

Nessuna dipendenza npm richiesta! Gli script usano:

  • Node.js built-in modules (fs, path, child_process)
  • Tool di sistema: unzip, tar, identify (ImageMagick), file

Opzionale (per funzionalità avanzate):

  • unrar — Supporto archivi RAR: sudo apt-get install unrar
  • ffprobe — Metadata video: sudo apt-get install ffmpeg

Vantaggi Node.js vs Python

  • Zero privilegi necessari (gira come user)
  • Nessuna dipendenza npm da installare
  • Tool di sistema per estrazione (più affidabili)
  • ImageMagick per metadata immagini (già installato su molti sistemi)