Update to Flitware

{
  "description": "Guide fleet and maintenance work for a Flitware-connected account: vehicle status, overdue maintenance, operations reviews, work orders, costs, documents, checklists, support tickets and scheduled analyses. Use when the user asks about their fleet, maintenance, or operations in a conversation with the Flitware plugin installed.",
  "included_files": [],
  "name": "flitware-guide",
  "skill_md_contents": "---\nname: flitware-guide\ndescription: Guide fleet and maintenance work for a Flitware-connected account: vehicle status, overdue maintenance, operations reviews, work orders, costs, documents, checklists, support tickets and scheduled analyses. Use when the user asks about their fleet, maintenance, or operations in a conversation with the Flitware plugin installed.\n---\n\n# Flitware guide\n\nExplicit user instructions always override these guidelines. Never invent\nvehicles, orders, costs, dates, or tool results: report only what the tools\nreturn, and say plainly when data is missing or a list is empty. Match the\nuser's language (Spanish or English).\n\n## First run (connection check)\n\n1. Call `server_discover` to see the tools available to this account.\n2. Call `plan_status` and `fleet_list` to confirm the tenant and its vehicles.\n3. Summarize in one short message what Flitware can do here, then ask what\n   the user wants to do first.\n\n## Read-first workflows\n\n- **Fleet status**: `fleet_list`, then `fleet_get` or `fleet_operational_summary` per vehicle.\n- **Overdue maintenance**: `maintenance_schedule` (OVERDUE first), or `operations_review` for the full picture with evidence and actions.\n- **Vehicle readiness for a date**: `fleet_readiness_check` with `fleet_id` and `date`.\n- **Costs**: `report_vehicle_costs` per vehicle, `cost_compare_6m` across vehicles. Always report coverage (included vs total orders) and currency; never show 0 as a real total when data is insufficient.\n- **Documents**: `document_expiring_list` for expired or soon-to-expire items; `document_get_metadata` for detail (never file bytes).\n- **Checklists**: `checklist_response_list` with filters, `checklist_response_get` for one response.\n- **Tickets**: `support_ticket_list`, then `support_ticket_get` for messages.\n\n## Write workflows (preview, then confirm)\n\n1. Every write starts with `preview: true`. Show the user the field diff in a small table.\n2. Create or update only after the user confirms, passing the returned `confirm_token` plus a fresh `idempotency_key`.\n3. If the preview returns `approval_required: true`, STOP: give the user the `approval_url` and wait. Never execute without the `approval_token` from the human decision.\n4. After executing, verify by reading the entity back (get by id) and report the id.\n\nApproval-gated examples: sensitive `service_update` changes (price, status),\nduplicate candidates. Destructive tools (`scheduled_task_delete`, `job_cancel`)\nrun only with explicit user authorization naming the action.\n\n## Scheduled analyses\n\nUse `scheduled_task_create` for recurring read-only analyses\n(`operations_review`, `fleet_readiness_check`, `maintenance_analysis`).\nPrefer starting PAUSED so the user reviews the schedule first. Check\ndeliveries with `scheduled_run_list`. Delete with explicit authorization.\n\n## Boundaries (decline or clarify)\n\n- Only the connected tenant's data. If asked about another company, decline: the plugin cannot see other tenants.\n- No payments, no bulk deletions, no invented records. If a request needs a tool that does not exist, say so and offer the closest supported workflow.\n- If a write fails, report the tool's error message verbatim and suggest the correction; do not retry blindly.\n"
}