# Orto Skills Suite v1.0 — Quick Start (Team Edition)

**Version:** 1.0  
**Release:** 2026-03-06  
**Status:** Production-Ready

---

## 🚀 Install in 3 Minutes

### Step 1: Extract Package

```bash
# Download orto-skills-v1.0-dist.tar.gz, then:
tar -xzf orto-skills-v1.0-dist.tar.gz
cd orto-skills
```

### Step 2: Run Installation Script

```bash
# Make executable (if needed)
chmod +x INSTALL.sh

# Run installer
./INSTALL.sh

# Output:
# ✅ 9 skills installed to ~/.openclaw/skills/orto-suite/
```

### Step 3: Create Your First Garden

```bash
# Initialize garden (Roma example)
openclaw invoke ~/.openclaw/skills/orto-suite/orto-init/SKILL.md \
  --id orto_roma_001 \
  --name "My Garden" \
  --provincia Roma \
  --regione Lazio \
  --lat 41.8782 \
  --lon 12.4922

# Output:
# ✅ Garden created at ~/.openclaw/workspace/Orti/orto_roma_001/
```

---

## 📋 Complete Workflow (15 Minutes)

### 1. Onboarding (Collect Profile)

```bash
openclaw invoke ~/.openclaw/skills/orto-suite/orto-onboarding/SKILL.md \
  --orto-id orto_roma_001

# Interactive questionnaire (5 blocks):
# - Localizzazione (location, access, property)
# - Layout spazio (area, soil, sun exposure)
# - Irrigazione (water source, constraints)
# - Comunità & Dieta (people, diet preferences)
# - Obiettivi & Vincoli (time, goals, experience)
```

### 2. Generate Full Plan

```bash
openclaw invoke ~/.openclaw/skills/orto-suite/orto-orchestratore/SKILL.md \
  --orto-id orto_roma_001

# Runs all 7 planning skills in sequence:
# - orto-agronomo (crop selection)
# - orto-calendario (weekly schedule)
# - orto-layout (bed design)
# - orto-irrigazione (irrigation zones)
# - orto-meteo-decisioni (weather forecast)
# - orto-fitopatologo (disease prevention)
# - Orchestration (merge + conflict resolution)

# Output: 10+ markdown files in ~/.openclaw/workspace/Orti/orto_roma_001/
```

### 3. Check Your Plan

```bash
cat ~/.openclaw/workspace/Orti/orto_roma_001/PlanBundle_Master.md

# View complete seasonal plan with:
# - 12 crop varieties (selected for your diet + space)
# - 52-week calendar with task list
# - 3-zone irrigation schedule
# - Disease prevention plan (biologico)
# - Accessibility notes (if needed)
```

### 4. Weekly Briefing (Every Monday)

```bash
openclaw invoke ~/.openclaw/skills/orto-suite/orto-meteo-decisioni/SKILL.md \
  --orto-id orto_roma_001

# Weekly briefing with:
# - 7-day weather forecast
# - Irrigation adjustments
# - This week's task list
# - Alerts (frost, heat, wind)
```

---

## 🎯 Use Cases

### Use Case 1: Individual Gardener

```bash
# 1. Install skills
./INSTALL.sh

# 2. Create garden
./init.sh my_garden Rome

# 3. Run onboarding (answer 5 questions)
# 4. Get full plan (init → plan → briefing)
```

### Use Case 2: Community Garden (Multiple Gardens)

```bash
# Initialize multiple gardens
for location in roma milano torino; do
  openclaw invoke ... --id orto_${location}_001 ...
done

# Batch weekly briefings
for garden_id in orto_roma_001 orto_milano_001 orto_torino_001; do
  openclaw invoke ... --orto-id $garden_id
done
```

### Use Case 3: Educational Program

```bash
# Create gardens for students
for student_id in 001 002 003 004 005; do
  openclaw invoke ... --id orto_student_${student_id} ...
done

# Each student gets:
# - Personal garden plan
# - Weekly task list
# - Learning materials (via outputs)
# - Community collaboration
```

---

## 📚 Documentation

### Included Files

| File | Purpose |
|------|---------|
| **README.md** | Project overview |
| **INSTALLATION_GUIDE.md** | Detailed setup instructions |
| **INDEX.md** | Master navigation |
| **DELIVERY_SUMMARY.md** | Full project summary |
| **QUICK_START.md** | This file (quick reference) |
| **INSTALL.sh** | Automated installation script |

### Skill Documentation

Each skill folder contains **SKILL.md** with:
- Full documentation
- Usage examples
- Input/output schemas
- Error handling
- References

### Test Results

See **test/** folder for:
- Unit tests (9/9 PASS)
- Integration test (PASS)
- Smoke test (PASS)
- QA score: 0.94

---

## ⚙️ Configuration

### Change Installation Directory

```bash
export OPENCLAW_SKILLS_DIR=/custom/path
./INSTALL.sh

# Skills will install to: /custom/path/orto-suite/
```

### Customize Knowledge Base

Edit before installation:

```bash
# 1. Add crops to reference
vim references/colture_it.md

# 2. Add regional calendars
vim references/calendario_it.md

# 3. Re-run installation
./INSTALL.sh
```

### Tune Conflict Resolution Policies

Edit skill after installation:

```bash
vim ~/.openclaw/skills/orto-suite/orto-orchestratore/SKILL.md

# Search: "Conflict Resolution"
# Modify policies as needed
```

---

## 🐛 Troubleshooting

### Issue: "Command not found: openclaw"

**Solution:**
```bash
# Ensure OpenClaw is installed & in PATH
which openclaw

# If not found, install:
npm install -g @openclaw/cli

# Add to PATH (if needed):
export PATH="$PATH:/usr/local/bin"
```

### Issue: "Directory already exists"

**Solution:**
```bash
# INSTALL.sh backs up existing automatically
# Check backup:
ls -la ~/.openclaw/skills/orto-suite.backup.*/

# Or start fresh:
rm -rf ~/.openclaw/skills/orto-suite/
./INSTALL.sh
```

### Issue: "Weather API unreachable"

**Solution:**
```bash
# wttr.in fallback to open-meteo (automatic)
# If both fail, skills use cached forecast

# Check connectivity:
curl -s https://wttr.in/Roma

# Should return weather data
```

---

## 🔗 Quick Commands Reference

```bash
# Install skills
./INSTALL.sh

# Initialize garden
openclaw invoke ~/.openclaw/skills/orto-suite/orto-init/SKILL.md \
  --id orto_TOWN_001 --name "Garden" --provincia PROV --regione REG \
  --lat LAT --lon LON

# Collect profile
openclaw invoke ~/.openclaw/skills/orto-suite/orto-onboarding/SKILL.md \
  --orto-id orto_TOWN_001

# Full planning
openclaw invoke ~/.openclaw/skills/orto-suite/orto-orchestratore/SKILL.md \
  --orto-id orto_TOWN_001

# Weekly briefing
openclaw invoke ~/.openclaw/skills/orto-suite/orto-meteo-decisioni/SKILL.md \
  --orto-id orto_TOWN_001

# View master plan
cat ~/.openclaw/workspace/Orti/orto_TOWN_001/PlanBundle_Master.md

# View weekly briefing
cat ~/.openclaw/workspace/Orti/orto_TOWN_001/briefing_settimanale_week_1.md
```

---

## 📊 What You Get

### Garden Planning
✅ Seasonal planning (init → profile → full plan)  
✅ Crop selection (12+ varieties matching your diet)  
✅ Weekly task lists (52 weeks × 3-5 tasks/week)  
✅ Irrigation scheduling (3 zones, baseline + meteo-adaptive)  

### Support & Safety
✅ Disease prevention (biological treatments)  
✅ Accessibility features (family-friendly)  
✅ Weather integration (forecast → decisions)  
✅ Audit trail (every operation logged)  

### Tools & Integration
✅ Markdown output (editable, versionable)  
✅ Modular skills (use independently)  
✅ Conflict resolution (policies built-in)  
✅ Open references (Italian domain data)  

---

## 🎓 Learning Path

**Beginner:** Start with QUICK_START.md (this file)  
**Intermediate:** Follow INSTALLATION_GUIDE.md  
**Advanced:** Read individual SKILL.md files  
**Expert:** Review test artifacts + architecture docs  

---

## 🌱 Next Steps

1. ✅ **Install locally** — `./INSTALL.sh`
2. ✅ **Create first garden** — `orto-init` + `orto-onboarding`
3. ✅ **Generate plan** — `orto-orchestratore`
4. ✅ **Get weekly briefing** — `orto-meteo-decisioni`
5. ✅ **Share with team** — Distribute this package

---

## 💬 Support

**Questions about installation?**  
→ See INSTALLATION_GUIDE.md

**Questions about a specific skill?**  
→ Read that skill's SKILL.md

**Issues or bugs?**  
→ Check test/ folder (all tests pass)

**Want to customize?**  
→ Edit references/ or skill SKILL.md files

---

## 📋 System Requirements

| Requirement | Version | Notes |
|------------|---------|-------|
| OpenClaw | ≥ 25.7 | For skill orchestration |
| Python | ≥ 3.8 | For internal scripts |
| Bash | ≥ 4.0 | For INSTALL.sh script |
| Internet | Optional | For weather API (fallback available) |

---

## 🎁 Distribution

### Share This Package With Your Team

```bash
# Send to team:
# 1. orto-skills-v1.0-dist.tar.gz (77 KB)
# 2. QUICK_START.md (this file)
# 3. INSTALLATION_GUIDE.md (for detailed help)

# Each team member:
# 1. Extract tar.gz
# 2. Run ./INSTALL.sh
# 3. Follow QUICK_START (above)
# 4. Start gardening!
```

---

**Version:** 1.0  
**Release Date:** 2026-03-06  
**Status:** Production-Ready  

🌱 **Orto Skills Suite — Ready to cultivate with your team!**