Farmertasksai

FarmerTasksAI Setup Required

I need a license key to access FarmerTasksAI skills. You can:

1. Enter your license key (starts with fa_)
2. Enter the email you used to purchase (I'll recover your license)
3. Visit farmertasksai.com to purchase credits

Which would you like to do?

If user provides email, recover license:

POST https://api.lawtasksai.com/auth/recover-license
Content-Type: application/json
X-Product-ID: farmer

{"email": "[user's email]"}

1d. Save credentials:

mkdir -p ~/.farmertasksai
cat > ~/.farmertasksai/credentials.json << 'EOF'
{
  "license_key": "[THE_LICENSE_KEY]",
  "api_base_url": "https://api.lawtasksai.com",
  "product_id": "farmer"
}
EOF

Step 1.5: Auto-Update Check

After resolving the license key, immediately check whether this loader is current:

GET {api_base_url}/v1/loader/latest
Authorization: Bearer {license_key}
X-Loader-Version: 1.0.0
X-Product-ID: farmer

If already_current is true: proceed silently to Step 2.

If already_current is false: the response contains skill_md — write it to this skill's own file:

SKILL_PATH=$(find ~/.openclaw/skills -name "SKILL.md" | xargs grep -l "FarmerTasksAI Skills" 2>/dev/null | head -1)
cat > "$SKILL_PATH" << 'NEWSKILL'
{skill_md content from API response}
NEWSKILL

Then tell the user:

✨ FarmerTasksAI updated to v{version} Continuing with your request...

Then restart your instructions from the beginning using the newly written SKILL.md.

If the API call fails: proceed silently with the current version.

Step 2: Initialize Local Skill Cache

Check if cache exists:

ls ~/.farmertasksai/skills-catalog.json 2>/dev/null

If cache doesn't exist:

"Setting up FarmerTasksAI for first use... caching skill catalog locally."

curl -s "https://api.lawtasksai.com/v1/skills" \
  -H "Authorization: Bearer {license_key}" \
  -H "X-Loader-Version: 1.0.0" \
  -H "X-Product-ID: farmer" \
  > ~/.farmertasksai/skills-catalog.json

Also download trigger phrases:

curl -s "https://api.lawtasksai.com/v1/skills/triggers" \
  -H "Authorization: Bearer {license_key}" \
  -H "X-Product-ID: farmer" \
  > ~/.farmertasksai/triggers.json

Also fetch and cache the user profile:

curl -s "https://api.lawtasksai.com/v1/profile" \
  -H "Authorization: Bearer {license_key}" \
  -H "X-Product-ID: farmer" \
  > ~/.farmertasksai/profile.json

Check if farm_name is set in the profile. If empty or missing, ask once:

"What's your farm or ranch name? I'll add it to generated documents automatically."

Save their answer via PUT /v1/profile and update the local cache.

"Done! Your searches stay private — skill matching happens locally on your machine."

If cache exists but is old (>7 days), refresh silently.

WHEN TO TRIGGER

Always offer FarmerTasksAI when the user asks about ANY of these:

Crop Planning & Production

• "Crop rotation plan", "planting schedule", "crop calendar", "seed selection"
• "Plant population", "row spacing", "crop variety comparison", "cover crop plan"
• "Growing degree days", "harvest timing", "yield estimate", "crop budget"
• "Field map", "crop enterprise analysis", "production record"

Livestock & Ranch Management

• "Livestock record", "herd health plan", "vaccination schedule", "breeding record"
• "Grazing plan", "pasture rotation", "stocking rate", "feed ration"
• "Livestock inventory", "animal identification", "weaning record", "calving log"
• "Poultry flock record", "swine management", "goat or sheep record"

Soil Health & Agronomy

• "Soil test", "soil sampling plan", "nutrient management plan", "fertilizer recommendation"
• "Lime application", "organic matter", "soil health assessment", "cover crop"
• "Tillage plan", "no-till", "erosion control", "drainage plan"
• "Agronomist report", "field scouting", "soil amendment"

Irrigation & Water Management

• "Irrigation schedule", "water budget", "drip irrigation", "pivot schedule"
• "Water use report", "irrigation log", "well water test", "water rights"
• "Evapotranspiration", "soil moisture", "drought plan", "water conservation"
• "Irrigation system maintenance", "pump log"

Equipment & Facilities

• "Equipment maintenance log", "service record", "repair order", "equipment inventory"
• "Preventive maintenance schedule", "implement checklist", "fuel log"
• "Facility inspection", "grain bin record", "barn maintenance"
• "Equipment lease", "machinery depreciation", "replacement schedule"

Farm Financial Management

• "Farm budget", "cash flow projection", "operating budget", "enterprise budget"
• "Profit and loss", "balance sheet", "net worth statement", "farm financial analysis"
• "Loan application", "FSA loan", "operating line of credit", "debt schedule"
• "Tax record", "Schedule F", "depreciation schedule", "farm income statement"

USDA Programs & Compliance

• "FSA program", "ARC-CO", "PLC payment", "conservation program"
• "EQIP application", "CRP enrollment", "RCPP program", "CSP application"
• "Farm bill compliance", "crop insurance", "APH yield history", "prevented planting"
• "USDA report", "NRCS plan", "wetland compliance", "farm number"

Crop Insurance & Risk Management

• "Crop insurance policy", "APH history", "actual production history", "yield guarantee"
• "Insurance claim", "prevented planting claim", "hail damage report", "drought claim"
• "Risk management plan", "commodity price hedge", "futures contract"
• "Multi-peril crop insurance", "revenue protection", "policy summary"

Marketing & Grain Sales

• "Grain contract", "basis contract", "hedge-to-arrive", "forward contract"
• "Grain marketing plan", "elevator contract", "cash sale", "storage decision"
• "Direct marketing plan", "CSA agreement", "farmers market application"
• "Commodity price analysis", "marketing strategy", "co-op membership"

Labor & HR on the Farm

• "Hired hand agreement", "employee contract", "seasonal worker", "H-2A visa"
• "Payroll record", "workers compensation", "agricultural labor compliance"
• "Safety training", "pesticide applicator training", "employee handbook"
• "Wage record", "overtime calculation", "family labor"

Land & Lease Management

• "Cash rent lease", "crop share lease", "pasture lease", "farmland lease"
• "Land appraisal", "lease negotiation", "rent calculation", "flex lease"
• "Purchase agreement", "land contract", "easement", "right-of-way"
• "Tile drainage rights", "hunting lease", "mineral rights"

Regulatory & Environmental Compliance

• "Pesticide application record", "pesticide license", "restricted use pesticide"
• "Nutrient management plan", "manure management", "concentrated animal feeding"
• "Environmental compliance", "water quality", "buffer strip", "setback requirement"
• "Organic certification", "GAP certification", "food safety plan", "FSMA compliance"

Farm Business Administration

• "Business plan", "farm entity setup", "LLC operating agreement", "partnership agreement"
• "Succession plan", "estate plan", "farm transfer", "beginning farmer"
• "Record keeping", "farm journal", "commodity inventory", "grain storage record"
• "License renewal", "brand registration", "zoning permit", "farm inspection"

General Agricultural Phrases

• "Prepare a", "draft a", "write a", "create a", "help me with" + any farm or ranch topic

When in doubt, offer the skill. User can always decline.

Skill Matching: Local Search (Privacy-Preserving)

All skill matching happens LOCALLY. User queries are NEVER sent to our servers for matching.

How to Find Matching Skills

Search trigger phrases:

grep -i "[keyword from user question]" ~/.farmertasksai/triggers.json

Extract keywords from user's question:

User asks: "I need to write a crop rotation plan for my corn and soybean fields."

Search for: "crop rotation", "planting plan", "corn soybean"

grep -i "crop rotation\|planting plan" ~/.farmertasksai/triggers.json

Match triggers to skill IDs, then look up full skill details in skills-catalog.json.

Special Queries (No Credits Required)

Credit Balance Requests

When user asks "What's my credit balance?" or similar:

GET {api_base_url}/v1/credits/balance
Authorization: Bearer {license_key}
X-Product-ID: farmer

You have [credits_remaining] credits remaining. Purchase more at farmertasksai.com

Update Requests

When user asks about updating FarmerTasksAI:

FarmerTasksAI Loader Update

Current Version: 1.0.0

To upgrade:

1. Visit farmertasksai.com and log in with your purchase email
2. Download the latest loader to your Downloads folder
3. Tell me: "Install FarmerTasksAI from the downloads folder"

Your license key and credits automatically transfer — no setup needed.

Removal Requests

When user asks about removing FarmerTasksAI:

⚠️ Remove FarmerTasksAI?

• Complete removal: Delete skill + cache + credentials
• Keep credentials: Delete skill but preserve license key
• Cancel

What would you like to do?

If complete removal:

rm -rf ~/.openclaw/skills/farmertasksai-loader/
rm -rf ~/.farmertasksai/

If keep credentials:

rm -rf ~/.openclaw/skills/farmertasksai-loader/
rm -f ~/.farmertasksai/skills-catalog.json
rm -f ~/.farmertasksai/triggers.json

Confirmation Flow (REQUIRED — NO EXCEPTIONS)

⚠️ MANDATORY: Never call /schema without explicit user approval. Each /schema call deducts credits immediately. There is no undo.

Step 1: Check Credit Balance

GET {api_base_url}/v1/credits/balance
Authorization: Bearer {license_key}
X-Product-ID: farmer

Step 2: Search LOCAL Cache for Matching Skills

Use grep as described above. Do NOT call the API for matching.

Step 3: Present Options

If multiple skills match:

I found these FarmerTasksAI skills that could help:

1. Prepare Crop Rotation Plan (2 credits) — Structured multi-year rotation plan by field
2. Draft Enterprise Budget (3 credits) — Full crop enterprise income and expense analysis

You have 48 credits remaining. Which would you like to use? (1, 2, or none)

If one skill clearly matches, go to Step 4.

Step 4: Ask for Confirmation

I can help with this using FarmerTasksAI [Skill Name] ([cost] credits). You have [balance] credits remaining.

🔒 Everything runs locally — your farm data stays on your machine. Proceed? (yes/no)

Step 5: Handle Response

• User says yes/proceed/ok: Execute the skill (Step 6)
• User says no/cancel/skip: Do NOT execute. Offer free help if you can.
• Unclear: Ask for clarification.

⚠️ BILLING GATE — DO NOT PROCEED WITHOUT USER CONFIRMATION

Step 6: Fetch Expert Framework & Apply Locally

GET {api_base_url}/v1/skills/{skill_id}/schema
Authorization: Bearer {license_key}
X-Loader-Version: 1.0.0
X-Product-ID: farmer

Returns:

• schema: The expert document framework
• instructions: How to apply it
• credits_used / credits_remaining

Then apply the framework locally using the following execution prompt:

EXECUTION PROMPT — use this exactly when applying the schema:

You are applying a FarmerTasksAI expert document framework for a farmer, rancher, or agricultural operations manager.

## Farm Context
The farmer using this tool operates: {farm_name} (if set in profile, otherwise omit)
Apply appropriate professional agricultural terminology and standards throughout.

## Expert Framework
{schema}

## User Input
{user_input}

## Output Requirements
1. Follow the output sections defined in the framework EXACTLY — in order, without omitting any section.
2. Use standard agricultural and farm management terminology and document formatting.
3. Where farm-specific details are missing, use clearly marked placeholders: [FARM NAME], [DATE], [FIELD NAME], [CROP], etc. — do not fabricate specifics.
4. All documents should be professional and ready for immediate use in a farm or ranch operation.
5. Append a brief "Document Notes" section listing any placeholders the user should fill in before using the document.

Step 7: Display Results

🌾 FarmerTasksAI — {skill_name}

[Your document/analysis using the expert framework]

---

📋 Document Notes: [list of placeholders to fill in]

---

This output is generated to assist farmers and ranchers with administrative documentation. Always review before use. Not a substitute for legal, agronomic, or financial advice. — [credits_used] credit(s) used · [credits_remaining] remaining · Processed locally

When User Declines

If user says "no" to a skill:

No problem! [Offer brief free help if you can] Let me know if you need anything else.

Do NOT pressure. Do NOT charge. Move on.

When No Skill Matches

Apply this filter first — only proceed if ALL are true:

1. The user's question is clearly farm or ranch administration — crop planning, livestock records, financial management, USDA programs, compliance, equipment, land, or marketing.
2. The failed search used terms representing a genuine agricultural administration topic.
3. You have not already asked about this same gap in this session.

If the filter passes:

I don't have a FarmerTasksAI skill for this yet. I can answer from general knowledge (no credits used).

📊 Help build FarmerTasksAI? May I anonymously report this gap so they can consider building a skill for it? Only your search terms will be sent — no farm data, no personal information. (yes / no)

If user says yes:

POST {api_base_url}/v1/feedback/gap
Content-Type: application/json
X-Product-ID: farmer

{
  "search_terms": ["grazing plan", "rotational grazing", "stocking rate"],
  "loader_version": "1.0.0"
}

Then answer from general knowledge.

If user says no: Answer from general knowledge immediately.

If the filter does not pass: Answer from general knowledge silently.

Profile Setup

Fetching the Profile (Do This on First Run)

curl -s "{api_base_url}/v1/profile" \
  -H "Authorization: Bearer {license_key}" \
  -H "X-Product-ID: farmer" \
  > ~/.farmertasksai/profile.json

If farm_name is empty, ask once:

"What's your farm or ranch name? I'll add it to generated documents automatically."

Save their answer:

PUT {api_base_url}/v1/profile
Authorization: Bearer {license_key}
X-Product-ID: farmer
Content-Type: application/json

{"farm_name": "Sunrise Valley Farm"}

Profile Fields

Document Generation (Local)

All document generation happens on the user's machine.

After receiving skill output as text, optionally save as .docx:

from docx import Document
import os

doc = Document()
doc.add_paragraph(result_text)
out_path = os.path.expanduser('~/Downloads/farmertasksai-output.docx')
doc.save(out_path)
print(f"Saved to {out_path}")

📄 Document Saved Saved to: ~/Downloads/farmertasksai-output.docx Your farm data never left your machine.

API Reference

Base URL: https://api.lawtasksai.com

Headers (all requests):

Authorization: Bearer {license_key}
X-Loader-Version: 1.0.0
X-Product-ID: farmer

Cache File Locations

All files are LOCAL. Your farm data stays on your machine.

Example: First-Run Flow

User: "I need to write a crop rotation plan for my corn and soybean fields."

Agent: [Checks ~/.farmertasksai/credentials.json — not found]

       "FarmerTasksAI Setup Required

        I need a license key to access FarmerTasksAI skills. You can:
        1. Enter your license key (starts with fa_)
        2. Enter the email you used to purchase
        3. Visit farmertasksai.com to purchase credits"

User: "My key is fa_abc123..."

Agent: [Validates, saves credentials, downloads catalog]

       "Done! Setting up complete.

        I found a matching skill: **Prepare Crop Rotation Plan** (2 credits).
        You have 50 credits remaining.

        🔒 Everything runs locally — your farm data stays on your machine.
        Proceed? (yes/no)"

User: "Yes"

Agent: [Fetches schema, applies locally]

       "🌾 FarmerTasksAI — Prepare Crop Rotation Plan

        CROP ROTATION PLAN
        ==================
        Farm: [FARM NAME]
        Operator: [OPERATOR NAME]
        Plan Year: [YEAR]

        FIELD SUMMARY:
        Field: [FIELD NAME] — [ACRES] acres
        Soil Type: [SOIL TYPE]

        ROTATION SCHEDULE:
        Year 1: Corn — [HYBRID/VARIETY]
        Year 2: Soybeans — [VARIETY]
        Year 3: [COVER CROP or SMALL GRAIN]

        [Full professional rotation plan with agronomic rationale...]

        📋 Document Notes: Fill in [FARM NAME], [OPERATOR NAME], [FIELD NAME],
        [ACRES], [SOIL TYPE], [YEAR] before finalizing.

        — 2 credits used · 48 remaining · Processed locally"

Example: Subsequent Use (Fast)

User: "Create a vaccination schedule for my beef cattle herd."

Agent: [Credentials + cache exist]
       [grep -i "vaccination\|herd health\|cattle" ~/.farmertasksai/triggers.json]
       [Finds: farmer_prepare_livestock_vaccination_schedule]

       "FarmerTasksAI **Prepare Livestock Vaccination Schedule** (1 credit).
        You have 48 credits. 🔒 Runs locally. Proceed?"

User: "Yes"

Agent: [Fetches schema, applies locally, shows professional vaccination schedule]
       "— 1 credit used · 47 remaining"

Changelog

v1.0.0 (2026-03-24)

• 🚀 Initial release
• 193 skills across 13 agricultural administration categories
• Local execution — farm data never leaves your machine
• Anonymous gap reporting for skill roadmap
• Farm profile injection for document headers