# AGENTS.md — Istruzioni Installazione

**Per agenti LLM che ricevono framework-translator e devono installarlo come skill OpenClaw.**

---

## 🎯 Tuo Compito

L'utente ti ha chiesto di installare `framework-translator` come **skill OpenClaw** nel tuo workspace.

**Importante:** Questa è una skill che trasforma framework in AgentSkills. Va installata nella cartella skills di OpenClaw.

Segui questi step **in ordine**. Non saltare passaggi.

---

## 📋 Checklist Installazione

### Step 1: Verifica Pacchetto

```bash
# Se hai ricevuto uno zip:
unzip -l framework-translator.zip | head -20

# Se hai ricevuto una cartella:
ls -la framework-translator/
```

**Cosa cercare:**
- [ ] `SKILL.md` (file principale)
- [ ] `scripts/` (cartella con script bash)
- [ ] `test/` (cartella con test)
- [ ] `README.md` (documentazione)

Se mancano file critici → **Ferma installazione e notifica utente**

---

### Step 2: Installa come Skill OpenClaw

```bash
# Determina percorso skills OpenClaw
SKILLS_DIR="$HOME/.openclaw/skills"
WORKSPACE="$HOME/.openclaw/workspace"

# Verifica esistenza cartella skills
if [ ! -d "$SKILLS_DIR" ]; then
    echo "❌ Cartella skills non trovata: $SKILLS_DIR"
    echo "Creazione in corso..."
    mkdir -p "$SKILLS_DIR"
fi

# Installa framework-translator come skill
if [ -d "framework-translator" ]; then
    mv framework-translator "$SKILLS_DIR/"
    echo "✅ Installato come skill in: $SKILLS_DIR/framework-translator"
elif [ -f "framework-translator.zip" ]; then
    unzip framework-translator.zip -d "$SKILLS_DIR/"
    rm framework-translator.zip
    echo "✅ Skill installata in: $SKILLS_DIR/framework-translator"
fi

# Crea symlink nel workspace (opzionale, per accesso rapido)
if [ ! -L "$WORKSPACE/framework-translator" ]; then
    ln -s "$SKILLS_DIR/framework-translator" "$WORKSPACE/framework-translator"
    echo "✅ Symlink creato: $WORKSPACE/framework-translator → $SKILLS_DIR/framework-translator"
fi
```

**Nota:** Le skill OpenClaw risiedono in `~/.openclaw/skills/`, non nel workspace. Il symlink nel workspace è opzionale per accesso rapido.

---

### Step 3: Verifica Installazione

```bash
cd "$SKILLS_DIR/framework-translator"

# Verifica struttura
echo "=== Struttura ==="
ls -la

echo ""
echo "=== Script ==="
ls -la scripts/

echo ""
echo "=== Test ==="
ls -la test/

# Verifica permessi script
chmod +x scripts/*.sh
```

**Output atteso:**
```
README.md
SKILL.md
AGENTS.md
RELEASE.md
scripts/
test/
...
```

Se output diverso → **Notifica utente**

**Verifica skill caricata:**
```bash
# OpenClaw dovrebbe riconoscere automaticamente la skill
# Se non funziona, riavvia OpenClaw o carica manualmente
```

---

### Step 4: Leggi SKILL.md

```bash
# Leggi prime 50 righe per capire scopo
head -50 SKILL.md
```

**Cosa capire:**
- Scopo: Trasformare framework in AgentSkills
- Input: Percorso framework testuale
- Output: Suite di skills in `test/<framework>/`

---

### Step 5: Conferma all'Utente

**Messaggio tipo:**

```
✅ framework-translator installato con successo!

**Percorso:** ~/.openclaw/workspace/framework-translator

**Cosa include:**
- SKILL.md (istruzioni per trasformare framework)
- scripts/ (3 script bash per packaging)
- test/ (test orto_v1 → orto-skills v0.2-test)
- Documentazione (README, RELEASE, AGENTS)

**Come usare:**
"Esegui framework-translator su /path/to/framework"

Seguirò SKILL.md per:
1. Analizzare framework
2. Proporre mappatura (tua approvazione)
3. Estrarre knowledge → references
4. Generare AgentSkills
5. Creare pacchetto installabile

**Primo test consigliato:**
- Framework: Qualsiasi framework multi-agente
- Output: test/<framework>/ con skills + references
```

---

## 🚨 Gestione Errori

### Errore: Cartella skills non trovata

```
❌ Cartella skills OpenClaw non trovata

Crea automaticamente:
mkdir -p ~/.openclaw/skills

Oppure chiedi all'utente:
"Dov'è la cartella skills OpenClaw? Di solito è ~/.openclaw/skills"
```

---

### Errore: File mancanti

```
❌ File critici mancanti: [lista file]

Possibili cause:
- Zip corrotto
- Estrazione incompleta
- Percorso errato

Chiedi all'utente:
"Puoi verificare il pacchetto framework-translator? Mancano file critici."
```

---

### Errore: Permessi script

```bash
# Fix automatico
chmod +x scripts/*.sh

# Verifica
ls -la scripts/*.sh
```

---

## ✅ Conferma Finale

Dopo installazione completata:

1. **Conferma all'utente** (vedi Step 5)
2. **Attendi istruzioni** per primo framework da trasformare
3. **Tieni aperto** `SKILL.md` come riferimento
4. **Verifica skill attiva:** La skill dovrebbe essere automaticamente disponibile in OpenClaw

---

## 📖 Riferimenti

| File | Quando Leggere |
|------|----------------|
| `SKILL.md` | Sempre (istruzioni operative) |
| `test/README.md` | Prima di eseguire test |
| `RELEASE.md` | Per info release corrente |
| `README.md` | Panoramica generale |

---

**Nota:** Non eliminare mai `SKILL.md` — è il cuore della skill.

**Percorso installazione:** `~/.openclaw/skills/framework-translator/`

---

_framework-translator — AGENTS.md v0.3_  
_Aggiornato: 2026-03-07 — Installazione come skill OpenClaw_