farmos-land-portfolio_skill

Overview

This skill manages a FarmOS land portfolio: it queries owned and leased parcels, lease terms, landlord contacts, scheduled and overdue payments, and annual land costs. It also performs authenticated write operations for marking payments paid and executing or previewing lease renewals. The skill enforces strict data-completeness and access-control rules so users get accurate, full results.

How this skill works

Read operations use the integration /all endpoints to retrieve complete datasets for payments, leases, landlords, parcels, and finance breakdowns. Write operations (mark-paid, bulk mark-paid, renewal previews and execution, year-end rollover) require a JWT obtained via the farmos-auth helper and must be previewed before execution. The skill reports total record counts and fails loudly if a required endpoint returns an error or empty result.

When to use it

• Check upcoming or overdue land payments and get total amounts and record counts
• List all leased parcels or all owned parcels with acres and county
• Find leases expiring within a given window (e.g., 90 or 180 days)
• Retrieve landlord contact info and active lease counts (admin/manager only)
• Preview and then execute bulk lease renewals or year-end payment rollovers
• Mark single or multiple payments as paid, or mark payments by date range

Best practices

• Always use the /all integration endpoints for read queries to avoid truncated results
• Report the total count returned and explicitly say if complete data could not be retrieved
• Require admin or manager role by checking ~/.openclaw/farmos-users.json before exposing sensitive fields
• Preview bulk operations (lease renewals, year-end rollover) and confirm with the user before executing
• Use bulk-by-date endpoints when user asks to mark "all March payments" paid instead of iterating individually
• If an endpoint returns an error or empty set, report the failure instead of showing partial data

Example use cases

• Show all payments due in March and the total amount due, with record count
• List leases expiring in the next 180 days so the team can prioritize renewals
• Preview a 3% rent increase for selected leases and return the new payment schedule before applying
• Mark a batch of rent payments paid for a date range using the bulk-by-date endpoint
• Produce annual land cost by month and cost-per-field for P&L planning