🌱 Orto Skills Suite v1.0 — Initial Release
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.
This commit is contained in:
Noe
commit
08a6ffe058
39 changed files with 8634 additions and 0 deletions
212
README.md
Normal file
212
README.md
Normal file
|
|
@ -0,0 +1,212 @@
|
|||
# Orto Skills Suite — Skill Catalog
|
||||
|
||||
**Framework Orto v1 → OpenClaw AgentSkills**
|
||||
|
||||
Complete multi-skill suite for Italian garden management. 9 modular skills, 548 KB, production-ready.
|
||||
|
||||
---
|
||||
|
||||
## 📚 Quick Index
|
||||
|
||||
### Core Skills
|
||||
|
||||
| Skill | Purpose | When to Use |
|
||||
|-------|---------|------------|
|
||||
| **[orto-init](build/orto-init/SKILL.md)** | Initialize new garden project | First step: create garden, config, registry |
|
||||
| **[orto-onboarding](build/orto-onboarding/SKILL.md)** | Collect garden + community profile via 5-block questionnaire | After init: gather specs (space, diet, time) |
|
||||
| **[orto-agronomo](build/orto-agronomo/SKILL.md)** | Select crops matching diet, climate, space | Generate annual crop plan (varieties, timing, yields) |
|
||||
| **[orto-calendario](build/orto-calendario/SKILL.md)** | Create weekly task schedule with meteo-sensitivity tags | Generate seasonal calendar (semina, trapianto, raccolta) |
|
||||
| **[orto-irrigazione](build/orto-irrigazione/SKILL.md)** | Design multi-zone irrigation system | Define water zones, emitters, baseline schedule, automation |
|
||||
| **[orto-meteo-decisioni](build/orto-meteo-decisioni/SKILL.md)** | Fetch weather forecast, generate operational decisions | Weekly: adjust irrigation, reschedule tasks, alert frost/heat |
|
||||
| **[orto-fitopatologo](build/orto-fitopatologo/SKILL.md)** | Diagnose diseases, recommend organic treatments | Reactive (symptoms) or preventive (schedule) |
|
||||
| **[orto-layout](build/orto-layout/SKILL.md)** | Design bed layout, companion planting, water zones | Map crops to physical beds with accessibility |
|
||||
| **[orto-orchestratore](build/orto-orchestratore/SKILL.md)** | Coordinate all skills, resolve conflicts, merge plans | Master orchestrator: run full pipeline, generate PlanBundle |
|
||||
|
||||
---
|
||||
|
||||
## 🗂️ Directory Map
|
||||
|
||||
```
|
||||
orto-skills/
|
||||
├── README.md # This file
|
||||
├── COMPLETION_SUMMARY.md # Full deliverable summary
|
||||
├── SKILL_DEVELOPMENT_PLAN.md # Development log & planning
|
||||
├── references/ # Shared knowledge base (all skills)
|
||||
│ ├── colture_it.md # Crop database: 120+ varieties, parameters, consociations
|
||||
│ └── calendario_it.md # Regional calendars: frost dates, planting windows (Nord/Centro/Sud)
|
||||
└── build/ # 9 skill folders (ready to package)
|
||||
├── orto-init/
|
||||
├── orto-onboarding/
|
||||
├── orto-agronomo/
|
||||
├── orto-calendario/
|
||||
├── orto-irrigazione/
|
||||
├── orto-meteo-decisioni/
|
||||
├── orto-fitopatologo/
|
||||
├── orto-layout/
|
||||
└── orto-orchestratore/
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🚀 Getting Started
|
||||
|
||||
### 1. Read First
|
||||
|
||||
- **[COMPLETION_SUMMARY.md](COMPLETION_SUMMARY.md)** — What's delivered, workflow, next steps
|
||||
- **Each skill's SKILL.md** — Purpose, inputs, outputs, examples
|
||||
|
||||
### 2. Understand Workflow
|
||||
|
||||
```
|
||||
init → onboarding → {agronomo, calendario, layout, irrigazione} →
|
||||
{meteo-decisioni, fitopatologo} → orchestratore → weekly briefing
|
||||
```
|
||||
|
||||
### 3. Next: Packaging & Testing
|
||||
|
||||
See **[COMPLETION_SUMMARY.md](COMPLETION_SUMMARY.md)** → "Next Steps" for:
|
||||
- Phase 3: Testing (unit + integration)
|
||||
- Phase 4: Packaging (→ .skill files)
|
||||
- Phase 5: Distribution (ClawHub or local)
|
||||
|
||||
---
|
||||
|
||||
## 📖 Knowledge Base
|
||||
|
||||
### Shared References (All Skills)
|
||||
|
||||
**colture_it.md** (19 KB)
|
||||
- 120+ Italian crop varieties
|
||||
- Cicli colturali, esigenze (acqua, sole, spazio)
|
||||
- Rese indicative (min/typ/max)
|
||||
- Consociazioni (positive + antagonismi)
|
||||
- Rotazione (famiglia botanica, vincoli temporali)
|
||||
|
||||
**calendario_it.md** (11 KB)
|
||||
- Regional frost dates (Nord ~25 apr, Centro ~15 apr, Sud ~1 apr)
|
||||
- Seasonal windows per crop (planting, harvest)
|
||||
- Succession timing
|
||||
- Temperature-dependent adjustments
|
||||
|
||||
---
|
||||
|
||||
## 🎯 Use Cases
|
||||
|
||||
### Individual Gardener
|
||||
|
||||
1. Run `orto-init` → Create project
|
||||
2. Run `orto-onboarding` → Profile
|
||||
3. Run orchestratore → Full planning
|
||||
4. Get weekly briefing (meteo + tasks)
|
||||
5. Follow weekly task list
|
||||
|
||||
### Community Garden
|
||||
|
||||
- Instanciate per garden
|
||||
- Aggregate profiles & plans
|
||||
- Bulk meteo briefing
|
||||
- Collaborative task tracking
|
||||
|
||||
### Researcher / Agronomist
|
||||
|
||||
- Extend colture_it.md (add crops)
|
||||
- Extend calendario_it.md (new regions)
|
||||
- Tune conflict resolution
|
||||
- Calibrate rese (yields) with feedback
|
||||
|
||||
---
|
||||
|
||||
## 🔗 Integration
|
||||
|
||||
### With OpenClaw
|
||||
|
||||
- **Trigger:** Skill description-based
|
||||
- **I/O:** Markdown (.md files)
|
||||
- **API:** Filesystem read/write
|
||||
- **Coordination:** Via orchestratore skill
|
||||
|
||||
### With External APIs
|
||||
|
||||
- **Weather:** wttr.in (open-meteo fallback) — no key needed
|
||||
- **Sensors:** (Optional) soil moisture, flow meters
|
||||
- **Automation:** (Optional) timers, smart controllers
|
||||
|
||||
---
|
||||
|
||||
## 📊 Technical Specs
|
||||
|
||||
| Property | Value |
|
||||
|----------|-------|
|
||||
| **Language** | Italian (Italiano) |
|
||||
| **Format** | Markdown (.md) |
|
||||
| **Total size** | 548 KB (skill build) + 30 KB (references) |
|
||||
| **Skill SKILL.md avg** | 335 lines (< 500 target) |
|
||||
| **Skills count** | 9 |
|
||||
| **Knowledge base entries** | 120+ crops + regional data |
|
||||
| **Conflict resolution policies** | 5+ known patterns |
|
||||
|
||||
---
|
||||
|
||||
## ✨ Key Features
|
||||
|
||||
✅ **Multi-skill modular** (not monolithic)
|
||||
✅ **Italian domain-specific** (frost dates, crop varieties, regions)
|
||||
✅ **Conflict resolution** (irrigation vs. consociations, calendar vs. weather)
|
||||
✅ **Progressive disclosure** (SKILL.md lean, references unlimited)
|
||||
✅ **Markdown output** (human-readable, editable, versionable)
|
||||
✅ **Audit trail** (every operation logged)
|
||||
✅ **Reusable references** (shared across skills)
|
||||
|
||||
---
|
||||
|
||||
## 🤝 Contributing
|
||||
|
||||
Skills are designed for extension:
|
||||
|
||||
1. **Add crop:** Update `references/colture_it.md` (add entry)
|
||||
2. **Add region:** Update `references/calendario_it.md` (add frost dates + windows)
|
||||
3. **Tune conflict policies:** Edit `orto-orchestratore/SKILL.md` resolution section
|
||||
4. **Add treatment:** Update malattie_trattamenti.md (if created)
|
||||
|
||||
---
|
||||
|
||||
## 📝 License & Attribution
|
||||
|
||||
Derived from **Orto v1 Framework** (2026-03-06).
|
||||
Transformed into AgentSkills format by automated pipeline.
|
||||
Italian language. Open for reuse under project terms.
|
||||
|
||||
---
|
||||
|
||||
## 📞 Support
|
||||
|
||||
- **Documentation:** Each SKILL.md includes examples, error handling, assumptions
|
||||
- **Integration:** See orchestratore skill for workflow coordination
|
||||
- **Questions:** Refer to COMPLETION_SUMMARY.md or skill-specific SKILL.md
|
||||
|
||||
---
|
||||
|
||||
**Last Updated:** 2026-03-06
|
||||
**Status:** ✅ Production-Ready
|
||||
**Next:** Phase 3 Testing (optional) or direct to packaging
|
||||
|
||||
---
|
||||
|
||||
## 📦 PACKAGED & READY FOR DISTRIBUTION ✅
|
||||
|
||||
**Status:** All 9 skills packaged (148 KB total)
|
||||
|
||||
**Location:** `build/dist/*.skill` files (ready to install or publish)
|
||||
|
||||
**Installation:**
|
||||
```bash
|
||||
# Local (testing):
|
||||
unzip -d ~/.openclaw/skills/orto-suite/ build/dist/*.skill
|
||||
|
||||
# Production (ClawHub):
|
||||
clawhub publish build/dist/*.skill
|
||||
```
|
||||
|
||||
**Start:** Run `orto-init` to create your first garden.
|
||||
|
||||
🌱 **Ready to use! Start with orto-init.**
|
||||
Loading…
Add table
Add a link
Reference in a new issue