Aggiunti README.md e AGENTS.md

README.md (presentazione sintetica): - Cos'è framework-translator - Quick start OpenClaw (installazione via chat con zip) - Installazione manuale - Link documentazione - Tabella test eseguiti AGENTS.md (istruzioni per agenti LLM): - Checklist installazione in 5 step - Verifica pacchetto - Sposta in workspace - Verifica installazione - Leggi SKILL.md - Conferma all'utente - Gestione errori Entrambi i file essenziali per: - Nuovi utenti (README.md) - Agenti che installano skill (AGENTS.md)
2026-03-07 11:51:33 +01:00 · 2026-03-07 11:51:33 +01:00 · 2334e70acd
commit 2334e70acd
parent 140a8186b9
2 changed files with 342 additions and 0 deletions
--- a/README.md
+++ b/README.md
@ -0,0 +1,130 @@
+# 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)