📦 Update: Installazione come skill OpenClaw (non workspace)

- AGENTS.md: Specificato che va installato in ~/.openclaw/skills/
- AGENTS.md: Aggiunto symlink opzionale nel workspace per accesso rapido
- AGENTS.md: Aggiornati percorsi da WORKSPACE a SKILLS_DIR
- AGENTS.md: Aggiunta nota su caricamento automatico skill
- README.md: Aggiornate istruzioni installazione (skills/ non workspace/)
- README.md: Chiarito che skill risiede in ~/.openclaw/skills/
- README.md: Aggiornata versione a v0.3

Motivazione: Le skill OpenClaw devono essere in ~/.openclaw/skills/ per essere caricate automaticamente. Il workspace è solo per file di lavoro e progetti.
This commit is contained in:
AgentePotente 2026-03-07 13:03:13 +01:00
parent 2334e70acd
commit 8bcc7680f1
2 changed files with 66 additions and 31 deletions

View file

@ -1,12 +1,14 @@
# AGENTS.md — Istruzioni Installazione
**Per agenti LLM che ricevono framework-translator e devono installarlo.**
**Per agenti LLM che ricevono framework-translator e devono installarlo come skill OpenClaw.**
---
## 🎯 Tuo Compito
L'utente ti ha chiesto di installare `framework-translator` nel tuo workspace OpenClaw.
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.
@ -34,36 +36,45 @@ Se mancano file critici → **Ferma installazione e notifica utente**
---
### Step 2: Sposta in Workspace
### Step 2: Installa come Skill OpenClaw
```bash
# Determina percorso workspace OpenClaw
# Determina percorso skills OpenClaw
SKILLS_DIR="$HOME/.openclaw/skills"
WORKSPACE="$HOME/.openclaw/workspace"
# Verifica esistenza
if [ ! -d "$WORKSPACE" ]; then
echo "❌ Workspace non trovato: $WORKSPACE"
echo "Chiedi all'utente: 'Dov'è il tuo workspace OpenClaw?'"
exit 1
# 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
# Sposta framework-translator
# Installa framework-translator come skill
if [ -d "framework-translator" ]; then
mv framework-translator "$WORKSPACE/"
echo "✅ Spostato in: $WORKSPACE/framework-translator"
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 "$WORKSPACE/"
unzip framework-translator.zip -d "$SKILLS_DIR/"
rm framework-translator.zip
echo "✅ Estratto in: $WORKSPACE/framework-translator"
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 "$WORKSPACE/framework-translator"
cd "$SKILLS_DIR/framework-translator"
# Verifica struttura
echo "=== Struttura ==="
@ -94,6 +105,12 @@ 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
@ -144,13 +161,16 @@ Seguirò SKILL.md per:
## 🚨 Gestione Errori
### Errore: Workspace non trovato
### Errore: Cartella skills non trovata
```
Workspace OpenClaw non trovato
Cartella skills OpenClaw non trovata
Chiedi all'utente:
"Dov'è il tuo workspace OpenClaw? Di solito è ~/.openclaw/workspace"
Crea automaticamente:
mkdir -p ~/.openclaw/skills
Oppure chiedi all'utente:
"Dov'è la cartella skills OpenClaw? Di solito è ~/.openclaw/skills"
```
---
@ -190,6 +210,7 @@ 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
---
@ -206,7 +227,9 @@ Dopo installazione completata:
**Nota:** Non eliminare mai `SKILL.md` — è il cuore della skill.
**Percorso installazione:** `~/.openclaw/skills/framework-translator/`
---
_framework-translator — AGENTS.md v0.2_
_Aggiornato: 2026-03-07_
_framework-translator — AGENTS.md v0.3_
_Aggiornato: 2026-03-07 — Installazione come skill OpenClaw_