# Send Farmos Finance to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "farmos-finance",
    "name": "Farmos Finance",
    "source": "tencent",
    "type": "skill",
    "category": "数据分析",
    "sourceUrl": "https://clawhub.ai/brianppetty/farmos-finance",
    "canonicalUrl": "https://clawhub.ai/brianppetty/farmos-finance",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/farmos-finance",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=farmos-finance",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-23T16:43:11.935Z",
      "expiresAt": "2026-04-30T16:43:11.935Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
        "contentDisposition": "attachment; filename=\"4claw-imageboard-1.0.1.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/farmos-finance"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/farmos-finance",
    "downloadUrl": "https://openagent3.xyz/downloads/farmos-finance",
    "agentUrl": "https://openagent3.xyz/skills/farmos-finance/agent",
    "manifestUrl": "https://openagent3.xyz/skills/farmos-finance/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/farmos-finance/agent.md"
  }
}
```
## Documentation

### FarmOS Finance

Forward-looking cash flow planning and cost management. Projects future cash flows based on planned costs and expected revenue.

### Data Completeness

Always state totals when reporting financial data: "Total operating costs: $892,000 across 12 categories."
Cash flow projections combine multiple sources. If the marketing revenue side fails, say so — don't present costs without revenue as a complete picture.
If an endpoint returns an error, report the failure to the user rather than presenting partial financial data. Partial financial data is worse than no data.
For cost item listings, use /api/cost-items with crop_year — this returns all items without pagination.

### When This Skill Triggers

"What's our cash flow look like?"
"Cost per acre this year?"
"Breakeven price for corn?"
"Monthly expense projection"
"Show cost categories"
"What are our biggest expenses?"

### Authentication

ADMIN ONLY. This skill accesses sensitive financial data. Always use admin-level auth.

TOKEN=$(~/clawd/scripts/farmos-auth.sh admin)

Role mapping: Check ~/.clawdbot/farmos-users.json. If the sender is not admin, respond: "Financial data is restricted to farm owners. I can't access that for your account."

### API Base

http://100.102.77.110:8010

### Cost Summary

GET /api/integration/summary?crop_year=2025

Returns: Total costs by category for the crop year.

### Cash Flow (Simplified)

GET /api/integration/cash-flow-simple?crop_year=2025

Returns: Monthly outflow projections.

### Breakeven Analysis

GET /api/integration/breakeven?crop_year=2025

Returns: Cost per acre and cost per bushel by crop and entity. This tells you the minimum price needed to cover costs.

### Cost Categories

GET /api/categories
Authorization: Bearer {token}

Returns: Cost category definitions (fertilizer, seed, chemicals, fuel, insurance, etc.)

### Cost Items

GET /api/cost-items?crop_year=2025
Authorization: Bearer {token}

Returns: Individual cost line items with amounts, timing, entity allocation.

### Cash Flow Projection (Full)

GET /api/cash-flow/projection?crop_year=2025
Authorization: Bearer {token}

Returns: Complete monthly cash flow with costs AND revenue (from Marketing module). Shows when money goes out and comes in.

### Cash Flow Summary

GET /api/cash-flow/summary?crop_year=2025
Authorization: Bearer {token}

Returns: Summarized by category and month.

### Key Concepts

Cost categories: Per-unit (fertilizer, seed — calculated from rate x acres) vs annual totals (insurance, labor).
Timing: Costs are assigned to specific months. Multiple months = split evenly.
Entity allocation: Costs can be assigned to one entity, split across all by crop acres, or manually allocated.
Breakeven: Total costs / expected bushels = minimum price per bushel to cover costs.

### Usage Notes

Always specify crop_year parameter.
Breakeven is the most-asked question — answer it quickly and clearly.
Cash flow projection combines costs (this module) with revenue (marketing module).
NEVER share financial data with non-admin users. This includes cost per acre, breakeven, cash flow, or any cost details.
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: brianppetty
- Version: 1.0.0
## Source health
- Status: healthy
- Source download looks usable.
- Yavira can redirect you to the upstream package for this source.
- Health scope: source
- Reason: direct_download_ok
- Checked at: 2026-04-23T16:43:11.935Z
- Expires at: 2026-04-30T16:43:11.935Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/farmos-finance)
- [Send to Agent page](https://openagent3.xyz/skills/farmos-finance/agent)
- [JSON manifest](https://openagent3.xyz/skills/farmos-finance/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/farmos-finance/agent.md)
- [Download page](https://openagent3.xyz/downloads/farmos-finance)