# 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)