📦 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 # 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 ## 🎯 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. 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 ```bash
# Determina percorso workspace OpenClaw # Determina percorso skills OpenClaw
SKILLS_DIR="$HOME/.openclaw/skills"
WORKSPACE="$HOME/.openclaw/workspace" WORKSPACE="$HOME/.openclaw/workspace"
# Verifica esistenza # Verifica esistenza cartella skills
if [ ! -d "$WORKSPACE" ]; then if [ ! -d "$SKILLS_DIR" ]; then
echo "❌ Workspace non trovato: $WORKSPACE" echo "❌ Cartella skills non trovata: $SKILLS_DIR"
echo "Chiedi all'utente: 'Dov'è il tuo workspace OpenClaw?'" echo "Creazione in corso..."
exit 1 mkdir -p "$SKILLS_DIR"
fi fi
# Sposta framework-translator # Installa framework-translator come skill
if [ -d "framework-translator" ]; then if [ -d "framework-translator" ]; then
mv framework-translator "$WORKSPACE/" mv framework-translator "$SKILLS_DIR/"
echo "✅ Spostato in: $WORKSPACE/framework-translator" echo "✅ Installato come skill in: $SKILLS_DIR/framework-translator"
elif [ -f "framework-translator.zip" ]; then elif [ -f "framework-translator.zip" ]; then
unzip framework-translator.zip -d "$WORKSPACE/" unzip framework-translator.zip -d "$SKILLS_DIR/"
rm framework-translator.zip 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 fi
``` ```
**Nota:** Le skill OpenClaw risiedono in `~/.openclaw/skills/`, non nel workspace. Il symlink nel workspace è opzionale per accesso rapido.
--- ---
### Step 3: Verifica Installazione ### Step 3: Verifica Installazione
```bash ```bash
cd "$WORKSPACE/framework-translator" cd "$SKILLS_DIR/framework-translator"
# Verifica struttura # Verifica struttura
echo "=== Struttura ===" echo "=== Struttura ==="
@ -94,6 +105,12 @@ test/
Se output diverso → **Notifica utente** 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 ### Step 4: Leggi SKILL.md
@ -144,13 +161,16 @@ Seguirò SKILL.md per:
## 🚨 Gestione Errori ## 🚨 Gestione Errori
### Errore: Workspace non trovato ### Errore: Cartella skills non trovata
``` ```
Workspace OpenClaw non trovato Cartella skills OpenClaw non trovata
Chiedi all'utente: Crea automaticamente:
"Dov'è il tuo workspace OpenClaw? Di solito è ~/.openclaw/workspace" 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) 1. **Conferma all'utente** (vedi Step 5)
2. **Attendi istruzioni** per primo framework da trasformare 2. **Attendi istruzioni** per primo framework da trasformare
3. **Tieni aperto** `SKILL.md` come riferimento 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. **Nota:** Non eliminare mai `SKILL.md` — è il cuore della skill.
**Percorso installazione:** `~/.openclaw/skills/framework-translator/`
--- ---
_framework-translator — AGENTS.md v0.2_ _framework-translator — AGENTS.md v0.3_
_Aggiornato: 2026-03-07_ _Aggiornato: 2026-03-07 — Installazione come skill OpenClaw_

View file

@ -27,19 +27,21 @@ Framework-translator è una skill per agenti LLM che converte framework document
2. **Allega a OpenClaw:** 2. **Allega a OpenClaw:**
- Apri chat con il tuo agente OpenClaw - Apri chat con il tuo agente OpenClaw
- Allega `framework-translator.zip` - Allega `framework-translator.zip`
- Scrivi: *"Installa questa skill nel tuo workspace"* - Scrivi: *"Installa questa skill OpenClaw"*
3. **L'agente eseguirà:** 3. **L'agente eseguirà:**
```bash ```bash
unzip framework-translator.zip -d ~/.openclaw/workspace/ unzip framework-translator.zip -d ~/.openclaw/skills/
``` ```
4. **Verifica:** 4. **Verifica:**
```bash ```bash
cd ~/.openclaw/workspace/framework-translator cd ~/.openclaw/skills/framework-translator
ls -la ls -la
``` ```
**Nota:** Le skill OpenClaw risiedono in `~/.openclaw/skills/`, non nel workspace.
--- ---
### Installazione Manuale ### Installazione Manuale
@ -49,13 +51,15 @@ Framework-translator è una skill per agenti LLM che converte framework document
git clone ssh://forgejo@git.noelab.it/Robots/framework-translator.git git clone ssh://forgejo@git.noelab.it/Robots/framework-translator.git
cd framework-translator cd framework-translator
# Sposta in workspace OpenClaw (opzionale) # Installa come skill OpenClaw
cp -r . ~/.openclaw/workspace/framework-translator/ cp -r . ~/.openclaw/skills/framework-translator/
# Verifica # Verifica
ls -la ~/.openclaw/workspace/framework-translator/ ls -la ~/.openclaw/skills/framework-translator/
``` ```
**Importante:** Installa sempre come skill in `~/.openclaw/skills/` per essere caricata automaticamente da OpenClaw.
--- ---
## 📖 Documentazione ## 📖 Documentazione
@ -84,7 +88,7 @@ ls -la ~/.openclaw/workspace/framework-translator/
### Trasformare un Framework ### Trasformare un Framework
```bash ```bash
cd ~/.openclaw/workspace/framework-translator cd ~/.openclaw/skills/framework-translator
# Chiedi all'agente: # Chiedi all'agente:
"Esegui framework-translator su /path/to/framework" "Esegui framework-translator su /path/to/framework"
@ -99,15 +103,17 @@ L'agente seguirà [`SKILL.md`](SKILL.md) per:
**Output:** `test/<framework-name>/` con skills + references **Output:** `test/<framework-name>/` con skills + references
**Nota:** La skill è installata in `~/.openclaw/skills/framework-translator/` ma puoi accedere i file di output dal tuo workspace.
--- ---
## 📦 Struttura Repository ## 📦 Struttura Repository
``` ```
framework-translator/ framework-translator/ # Installato in ~/.openclaw/skills/
├── README.md # Questo file ├── README.md # Questo file
├── SKILL.md # Istruzioni LLM (Fasi 1-5) ├── SKILL.md # Istruzioni LLM (Fasi 1-5)
├── AGENTS.md # Istruzioni installazione agenti ├── AGENTS.md # Istruzioni installazione come skill
├── RELEASE.md # Note release ├── RELEASE.md # Note release
├── scripts/ # Script meccanici (bash) ├── scripts/ # Script meccanici (bash)
├── test/ # Test eseguiti ├── test/ # Test eseguiti
@ -127,4 +133,10 @@ framework-translator/
--- ---
**Licenza:** MIT **Licenza:** MIT
**Autore:** AgentePotente (via framework-translator skill) **Autore:** AgentePotente (via framework-translator skill)
**Installazione:** `~/.openclaw/skills/framework-translator/`
---
_framework-translator — README.md v0.3_
_Aggiornato: 2026-03-07 — Installazione come skill OpenClaw_