# framework-translator

**Trasforma framework testuali complessi in AgentSkills pronte all'uso.**

---

## 🎯 Cos'è

Framework-translator è una skill per agenti LLM che converte framework documentati (multi-agente, workflow, knowledge base) in suite di **AgentSkills** eseguibili e standardizzate.

**Input:** Framework testuale (es. `orto_v1/` con 12 agenti, 6 workflow, documentazione)  
**Output:** Suite di AgentSkills (es. `orto-skills/` con 7 skills + 11 references)

---

## 🚀 Quick Start (OpenClaw)

### Installazione via Chat

1. **Scarica il pacchetto:**
   ```bash
   git clone ssh://forgejo@git.noelab.it/Robots/framework-translator.git
   cd framework-translator
   zip -r framework-translator.zip .
   ```

2. **Allega a OpenClaw:**
   - Apri chat con il tuo agente OpenClaw
   - Allega `framework-translator.zip`
   - Scrivi: *"Installa questa skill nel tuo workspace"*

3. **L'agente eseguirà:**
   ```bash
   unzip framework-translator.zip -d ~/.openclaw/workspace/
   ```

4. **Verifica:**
   ```bash
   cd ~/.openclaw/workspace/framework-translator
   ls -la
   ```

---

### Installazione Manuale

```bash
# Clone
git clone ssh://forgejo@git.noelab.it/Robots/framework-translator.git
cd framework-translator

# Sposta in workspace OpenClaw (opzionale)
cp -r . ~/.openclaw/workspace/framework-translator/

# Verifica
ls -la ~/.openclaw/workspace/framework-translator/
```

---

## 📖 Documentazione

| File | Contenuto |
|------|-----------|
| [`SKILL.md`](SKILL.md) | **Istruzioni complete** per LLM (Fasi 1-5) |
| [`test/README.md`](test/README.md) | Come eseguire test su nuovi framework |
| [`RELEASE.md`](RELEASE.md) | Note release (v0.2-test attuale) |
| [`AGENTS.md`](AGENTS.md) | Istruzioni per agenti LLM (installazione) |

---

## 🧪 Test Eseguiti

| Test | Framework | Skills | References | Status |
|------|-----------|--------|------------|--------|
| #1 | `orto_v1` → `orto-skills` | 7/9 (78%) | 11/14 (79%) | ✅ v0.2-test |

**Dettagli:** Vedi [`test/README.md`](test/README.md)

---

## 🛠️ Uso

### Trasformare un Framework

```bash
cd ~/.openclaw/workspace/framework-translator

# Chiedi all'agente:
"Esegui framework-translator su /path/to/framework"
```

L'agente seguirà [`SKILL.md`](SKILL.md) per:
1. Analizzare il framework
2. Proporre mappatura (tua approvazione)
3. Estrarre knowledge
4. Generare skills
5. Creare pacchetto installabile

**Output:** `test/<framework-name>/` con skills + references

---

## 📦 Struttura Repository

```
framework-translator/
├── README.md              # Questo file
├── SKILL.md               # Istruzioni LLM (Fasi 1-5)
├── AGENTS.md              # Istruzioni installazione agenti
├── RELEASE.md             # Note release
├── scripts/               # Script meccanici (bash)
├── test/                  # Test eseguiti
│   ├── README.md
│   └── orto/              # Test: orto_v1 → orto-skills v0.2
└── ...
```

---

## 🔗 Link

- **Repository:** https://git.noelab.it/Robots/framework-translator
- **Release:** v0.2-test (2026-03-07)
- **Documentazione:** Vedi file sopra

---

**Licenza:** MIT  
**Autore:** AgentePotente (via framework-translator skill)