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

73 lines
2 KiB
Markdown

# agency-archivist
Gestione archivi di risorse (immagini, video, documenti) per progetti agency.
## Installazione
Copia la cartella in `~/.openclaw/skills/` o usa lo script:
```bash
cd ~/agency-skills-suite
./INSTALL.sh
```
## Utilizzo
### 1. Estrazione Archivio
```bash
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
```bash
node scripts/scan_resources.js --client demo_co_srl --pass 1
```
### 3. Generazione Catalogo
```bash
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)