framework-translator/AGENTS.md

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

# 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

# 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

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:

# OpenClaw dovrebbe riconoscere automaticamente la skill
# Se non funziona, riavvia OpenClaw o carica manualmente

---

Step 4: Leggi SKILL.md

# 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

# 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