orto-skills/QUICK_START.md

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

# 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

# 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

# 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)

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

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

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)

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

# 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)

# 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

# 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

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

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

Customize Knowledge Base

Edit before installation:

# 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:

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

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

---

🐛 Troubleshooting

Issue: "Command not found: openclaw"

Solution:

# 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:

# 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:

# 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

# 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

# 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!