08a6ffe058
Framework: Orto v1 → OpenClaw AgentSkills (Complete transformation) Release Date: 2026-03-06 Status: Production-Ready 📦 DELIVERABLES (39 files): - 9 × .skill files (packaged, ready to install) - 2 × reference files (colture_it.md, calendario_it.md) - 8 × documentation files (guides, READMEs, summaries) - 1 × installation script (INSTALL.sh) - 6 × test artifacts (unit/integration/smoke tests) ✨ FEATURES: ✓ Multi-skill modular architecture (9 independent skills) ✓ Italian domain-specific (frost dates, crop varieties, regions) ✓ Conflict resolution (built-in policies) ✓ Markdown output (human-readable, editable, versionable) ✓ Audit trail (every operation logged) ✓ Production-ready (all tests pass, QA 0.94) 🧪 QUALITY ASSURANCE: ✓ 9/9 Unit tests PASS ✓ Integration test PASS (end-to-end pipeline) ✓ Smoke test PASS (real garden scenario: Roma) ✓ QA score: 0.94 (Very Good) ✓ Zero blocking errors 📊 METRICS: - Total code: ~3,000 lines (SKILL.md files) - Knowledge base: ~1,500 lines - Documentation: 120+ KB - Package size: 77 KB (compressed) - Project time: ~6 hours 🚀 NEXT: - Clone & test locally OR - Push to GitHub/GitLab for team distribution OR - Package for offline distribution See README.md for quick start. See DELIVERY_SUMMARY.md for full project details.
396 lines
8.4 KiB
Markdown
396 lines
8.4 KiB
Markdown
# 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!**
|