# Send Vehicle Expense Tracker 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": "vehicle-tracker",
    "name": "Vehicle Expense Tracker",
    "source": "tencent",
    "type": "skill",
    "category": "效率提升",
    "sourceUrl": "https://clawhub.ai/huchengtw/vehicle-tracker",
    "canonicalUrl": "https://clawhub.ai/huchengtw/vehicle-tracker",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/vehicle-tracker",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=vehicle-tracker",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "config.json",
      "SKILL.md",
      "tracker.py",
      "locales/ja-JP.json",
      "locales/zh-TW.json",
      "locales/en-US.json"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "vehicle-tracker",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-01T14:41:32.098Z",
      "expiresAt": "2026-05-08T14:41:32.098Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=vehicle-tracker",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=vehicle-tracker",
        "contentDisposition": "attachment; filename=\"vehicle-tracker-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "vehicle-tracker"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/vehicle-tracker"
    },
    "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/vehicle-tracker",
    "downloadUrl": "https://openagent3.xyz/downloads/vehicle-tracker",
    "agentUrl": "https://openagent3.xyz/skills/vehicle-tracker/agent",
    "manifestUrl": "https://openagent3.xyz/skills/vehicle-tracker/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/vehicle-tracker/agent.md"
  }
}
```
## Documentation

### Vehicle Expense Tracker

A multi-language vehicle expense tracking tool that supports Google Sheets and local Excel files.

### Features

i18n Support: Multiple languages via locale files (locales/*.json)
Google Sheets Integration: Write directly to Google Sheets via API
Local Excel Fallback: Saves to local .xlsx files if no Spreadsheet ID configured
Metric/Imperial Units: Configurable unit system (km/L vs mi/gal)
Photo Management: Auto-saves and renames photos with timestamps
Aliases: Support vehicle aliases (e.g., "my car" → "Toyota Camry 2020")
Defaults: Auto-fill quantity and unit based on category

### Step 1: Choose Your Locale

Available locales:

zh-TW - 繁體中文 (Taiwan)
en-US - English (US)
ja-JP - 日本語

### Step 2: Create config.json

Copy the template below and save as skills/vehicle-tracker/config.json:

{
  "locale": "en-US",
  "unit_system": "metric",
  "vehicles": {},
  "aliases": {},
  "default_vehicle": null,
  "category_defaults": {}
}

### Step 3: Copy Category Defaults from Locale

Based on your chosen locale and unit system, copy the appropriate category defaults.

For English (metric):

{
  "category_defaults": {
    "Gas": { "unit": "liter" },
    "Accessory": { "unit": "pc", "quantity": 1 },
    "Repair": { "unit": "job", "quantity": 1 },
    "Maintenance": { "unit": "service", "quantity": 1 },
    "Purchase": { "unit": "unit", "quantity": 1 }
  }
}

For English (imperial):

{
  "category_defaults": {
    "Gas": { "unit": "gallon" },
    "Accessory": { "unit": "pc", "quantity": 1 },
    "Repair": { "unit": "job", "quantity": 1 },
    "Maintenance": { "unit": "service", "quantity": 1 },
    "Purchase": { "unit": "unit", "quantity": 1 }
  }
}

For 繁體中文 (metric):

{
  "category_defaults": {
    "加油": { "unit": "公升" },
    "周邊": { "unit": "個", "quantity": 1 },
    "維修": { "unit": "件", "quantity": 1 },
    "保養": { "unit": "次", "quantity": 1 },
    "買車": { "unit": "輛", "quantity": 1 }
  }
}

For 日本語 (metric):

{
  "category_defaults": {
    "給油": { "unit": "リットル" },
    "アクセサリー": { "unit": "個", "quantity": 1 },
    "修理": { "unit": "件", "quantity": 1 },
    "メンテナンス": { "unit": "回", "quantity": 1 },
    "購入": { "unit": "台", "quantity": 1 }
  }
}

### Step 4: Add Your Vehicle

Option A: Google Sheets (recommended for cloud sync)

Create a Google Spreadsheet
Share it with a Google Service Account (see google-workspace skill)
Add the Spreadsheet ID to config:

{
  "vehicles": {
    "My Car 2020": "1ABC123...xyz"
  },
  "default_vehicle": "My Car 2020"
}

Option B: Local Excel (no setup required)

Just add the vehicle name without an ID:

{
  "vehicles": {
    "My Car 2020": null
  },
  "default_vehicle": "My Car 2020"
}

Files will be saved to ~/vehicle_tracker/My_Car_2020.xlsx.

### Step 5: Add Aliases (Optional)

{
  "aliases": {
    "car": "My Car 2020",
    "toyota": "My Car 2020"
  }
}

### Step 6: Custom Paths (Optional)

Override default directories:

{
  "photo_base_dir": "/path/to/photos",
  "local_excel_dir": "/path/to/excel/files",
  "sheet_name": "Expenses"
}

Default paths: ~/vehicle_tracker

### Complete config.json Example

{
  "locale": "en-US",
  "unit_system": "imperial",
  "vehicles": {
    "Toyota Camry 2020": "1ABC123...spreadsheet_id",
    "Honda Civic 2018": null
  },
  "aliases": {
    "camry": "Toyota Camry 2020",
    "civic": "Honda Civic 2018",
    "car": "Toyota Camry 2020"
  },
  "default_vehicle": "Toyota Camry 2020",
  "category_defaults": {
    "Gas": { "unit": "gallon" },
    "Accessory": { "unit": "pc", "quantity": 1 },
    "Repair": { "unit": "job", "quantity": 1 },
    "Maintenance": { "unit": "service", "quantity": 1 },
    "Purchase": { "unit": "unit", "quantity": 1 }
  },
  "photo_base_dir": "~/vehicle_tracker",
  "local_excel_dir": "~/vehicle_tracker"
}

### Preview (Dry Run) - Always do this first!

python3 skills/vehicle-tracker/tracker.py \\
  --vehicle "camry" \\
  --mileage 15000 \\
  --category "Gas" \\
  --cost 45.50 \\
  --quantity 12.5 \\
  --dry-run

### Execute (After user confirms)

python3 skills/vehicle-tracker/tracker.py \\
  --vehicle "camry" \\
  --mileage 15000 \\
  --category "Gas" \\
  --cost 45.50 \\
  --quantity 12.5

### With Photos

python3 skills/vehicle-tracker/tracker.py \\
  --vehicle "camry" \\
  --mileage 15200 \\
  --category "Maintenance" \\
  --cost 89.99 \\
  --description "Oil change" \\
  --photos "/path/to/receipt.jpg" \\
  --dry-run

### Arguments

ArgumentRequiredDescription--vehicleOptionalVehicle name or alias. Uses default if omitted.--mileageRequiredCurrent odometer reading--categoryRequiredExpense category--costRequiredExpense amount (currency symbols auto-removed)--quantityOptionalQuantity (uses default if available)--unitOptionalUnit (uses category mapping if available)--dateOptionalDate YYYY-MM-DD (defaults to today)--descriptionOptionalAdditional notes--photosOptionalPhoto file paths to save--dry-runFlagPreview only, no write

### Adding a New Locale

Create locales/{code}.json based on existing locale files. Required fields:

language_name
sheet_name
columns_metric / columns_imperial
photo_prefix
messages
units_metric / units_imperial
default_units_metric / default_units_imperial

### Supported Locales

CodeLanguageUnit Systemszh-TW繁體中文metric, imperialen-USEnglish (US)metric, imperialja-JP日本語metric, imperial
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: huchengtw
- Version: 1.0.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-01T14:41:32.098Z
- Expires at: 2026-05-08T14:41:32.098Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/vehicle-tracker)
- [Send to Agent page](https://openagent3.xyz/skills/vehicle-tracker/agent)
- [JSON manifest](https://openagent3.xyz/skills/vehicle-tracker/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/vehicle-tracker/agent.md)
- [Download page](https://openagent3.xyz/downloads/vehicle-tracker)