{
  "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": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/farmos-finance",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=farmos-finance",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "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."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "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."
        },
        {
          "label": "Upgrade existing",
          "body": "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."
        }
      ]
    },
    "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."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/farmos-finance",
    "agentPageUrl": "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"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "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."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "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."
      },
      {
        "label": "Upgrade existing",
        "body": "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."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "FarmOS Finance",
        "body": "Forward-looking cash flow planning and cost management. Projects future cash flows based on planned costs and expected revenue."
      },
      {
        "title": "Data Completeness",
        "body": "Always state totals when reporting financial data: \"Total operating costs: $892,000 across 12 categories.\"\nCash flow projections combine multiple sources. If the marketing revenue side fails, say so — don't present costs without revenue as a complete picture.\nIf 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.\nFor cost item listings, use /api/cost-items with crop_year — this returns all items without pagination."
      },
      {
        "title": "When This Skill Triggers",
        "body": "\"What's our cash flow look like?\"\n\"Cost per acre this year?\"\n\"Breakeven price for corn?\"\n\"Monthly expense projection\"\n\"Show cost categories\"\n\"What are our biggest expenses?\""
      },
      {
        "title": "Authentication",
        "body": "ADMIN ONLY. This skill accesses sensitive financial data. Always use admin-level auth.\n\nTOKEN=$(~/clawd/scripts/farmos-auth.sh admin)\n\nRole 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.\""
      },
      {
        "title": "API Base",
        "body": "http://100.102.77.110:8010"
      },
      {
        "title": "Cost Summary",
        "body": "GET /api/integration/summary?crop_year=2025\n\nReturns: Total costs by category for the crop year."
      },
      {
        "title": "Cash Flow (Simplified)",
        "body": "GET /api/integration/cash-flow-simple?crop_year=2025\n\nReturns: Monthly outflow projections."
      },
      {
        "title": "Breakeven Analysis",
        "body": "GET /api/integration/breakeven?crop_year=2025\n\nReturns: Cost per acre and cost per bushel by crop and entity. This tells you the minimum price needed to cover costs."
      },
      {
        "title": "Cost Categories",
        "body": "GET /api/categories\nAuthorization: Bearer {token}\n\nReturns: Cost category definitions (fertilizer, seed, chemicals, fuel, insurance, etc.)"
      },
      {
        "title": "Cost Items",
        "body": "GET /api/cost-items?crop_year=2025\nAuthorization: Bearer {token}\n\nReturns: Individual cost line items with amounts, timing, entity allocation."
      },
      {
        "title": "Cash Flow Projection (Full)",
        "body": "GET /api/cash-flow/projection?crop_year=2025\nAuthorization: Bearer {token}\n\nReturns: Complete monthly cash flow with costs AND revenue (from Marketing module). Shows when money goes out and comes in."
      },
      {
        "title": "Cash Flow Summary",
        "body": "GET /api/cash-flow/summary?crop_year=2025\nAuthorization: Bearer {token}\n\nReturns: Summarized by category and month."
      },
      {
        "title": "Key Concepts",
        "body": "Cost categories: Per-unit (fertilizer, seed — calculated from rate x acres) vs annual totals (insurance, labor).\nTiming: Costs are assigned to specific months. Multiple months = split evenly.\nEntity allocation: Costs can be assigned to one entity, split across all by crop acres, or manually allocated.\nBreakeven: Total costs / expected bushels = minimum price per bushel to cover costs."
      },
      {
        "title": "Usage Notes",
        "body": "Always specify crop_year parameter.\nBreakeven is the most-asked question — answer it quickly and clearly.\nCash flow projection combines costs (this module) with revenue (marketing module).\nNEVER share financial data with non-admin users. This includes cost per acre, breakeven, cash flow, or any cost details."
      }
    ],
    "body": "FarmOS Finance\n\nForward-looking cash flow planning and cost management. Projects future cash flows based on planned costs and expected revenue.\n\nData Completeness\nAlways state totals when reporting financial data: \"Total operating costs: $892,000 across 12 categories.\"\nCash flow projections combine multiple sources. If the marketing revenue side fails, say so — don't present costs without revenue as a complete picture.\nIf 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.\nFor cost item listings, use /api/cost-items with crop_year — this returns all items without pagination.\nWhen This Skill Triggers\n\"What's our cash flow look like?\"\n\"Cost per acre this year?\"\n\"Breakeven price for corn?\"\n\"Monthly expense projection\"\n\"Show cost categories\"\n\"What are our biggest expenses?\"\nAuthentication\n\nADMIN ONLY. This skill accesses sensitive financial data. Always use admin-level auth.\n\nTOKEN=$(~/clawd/scripts/farmos-auth.sh admin)\n\n\nRole 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.\"\n\nAPI Base\n\nhttp://100.102.77.110:8010\n\nIntegration Endpoints (No Auth — if AI access toggle is enabled)\nCost Summary\n\nGET /api/integration/summary?crop_year=2025\n\nReturns: Total costs by category for the crop year.\n\nCash Flow (Simplified)\n\nGET /api/integration/cash-flow-simple?crop_year=2025\n\nReturns: Monthly outflow projections.\n\nBreakeven Analysis\n\nGET /api/integration/breakeven?crop_year=2025\n\nReturns: Cost per acre and cost per bushel by crop and entity. This tells you the minimum price needed to cover costs.\n\nAuthenticated Endpoints (JWT Required)\nCost Categories\n\nGET /api/categories Authorization: Bearer {token}\n\nReturns: Cost category definitions (fertilizer, seed, chemicals, fuel, insurance, etc.)\n\nCost Items\n\nGET /api/cost-items?crop_year=2025 Authorization: Bearer {token}\n\nReturns: Individual cost line items with amounts, timing, entity allocation.\n\nCash Flow Projection (Full)\n\nGET /api/cash-flow/projection?crop_year=2025 Authorization: Bearer {token}\n\nReturns: Complete monthly cash flow with costs AND revenue (from Marketing module). Shows when money goes out and comes in.\n\nCash Flow Summary\n\nGET /api/cash-flow/summary?crop_year=2025 Authorization: Bearer {token}\n\nReturns: Summarized by category and month.\n\nKey Concepts\nCost categories: Per-unit (fertilizer, seed — calculated from rate x acres) vs annual totals (insurance, labor).\nTiming: Costs are assigned to specific months. Multiple months = split evenly.\nEntity allocation: Costs can be assigned to one entity, split across all by crop acres, or manually allocated.\nBreakeven: Total costs / expected bushels = minimum price per bushel to cover costs.\nUsage Notes\nAlways specify crop_year parameter.\nBreakeven is the most-asked question — answer it quickly and clearly.\nCash flow projection combines costs (this module) with revenue (marketing module).\nNEVER share financial data with non-admin users. This includes cost per acre, breakeven, cash flow, or any cost details."
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/brianppetty/farmos-finance",
    "publisherUrl": "https://clawhub.ai/brianppetty/farmos-finance",
    "owner": "brianppetty",
    "version": "1.0.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "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"
  }
}