vehicle-setup

name	vehicle-setup
description	Guide users through Slovak VAT Act 2025 compliant vehicle registration with VIN validation

Vehicle Setup Skill

Purpose

Guide users through Slovak VAT Act 2025 compliant vehicle registration with VIN validation.

When to Activate

• Trigger words: "add vehicle", "register car", "new vehicle"
• License plate patterns: "BA-", "-123*"
• Vehicle brands: "Ford", "BMW", "Škoda"

Instructions

Step 1: Collect Mandatory Fields

Ask conversationally for:

1. License Plate (Slovak format: XX-123XX, e.g., BA-456CD)

   • Validate format: 2 letters + hyphen + 3 digits + 2 letters
   • Example: "BA-789XY"

2. VIN (17 characters, no I/O/Q - mandatory for Slovak VAT Act 2025)

   • Validate: exactly 17 characters, no I/O/Q letters
   • If invalid: "VIN cannot contain letters I, O, or Q. Please verify."
   • Explain: "VIN is required for tax deduction eligibility in Slovakia"

3. Fuel Type (Diesel, Gasoline 95/98, LPG, Hybrid, Electric)

   • Suggest typical efficiency: Diesel 8.5 L/100km, Gasoline 9.5 L/100km
   • Always use L/100km format (European standard), never km/L

4. Current Odometer (kilometers)

   • Validate: > 0, < 1,000,000 km
   • Ask: "What's the current odometer reading in kilometers?"

Step 2: Show Summary & Confirm

Present clear summary before creating:

Summary:
• Name: Ford Transit Delivery Van
• Plate: BA-789XY
• VIN: WVWZZZ3CZDP123456
• Fuel: Diesel (avg 8.5 L/100km)
• Odometer: 125,000 km

Create this vehicle? (yes/no)

Step 3: Create Vehicle

• Call MCP tool: car-log-core.create_vehicle
• Request: { name, license_plate, vin, fuel_type, make, model, year, initial_odometer_km }
• Success: "✅ [Vehicle name] registered! Ready to track trips."
• Error: Explain issue, offer to retry

Validation Rules

• VIN: Must match ^[A-HJ-NPR-Z0-9]{17}$ (no I, O, Q)
• License Plate: Must match ^[A-Z]{2}-[0-9]{3}[A-Z]{2}$
• Fuel Efficiency: Always L/100km (European standard), never km/L

Slovak Compliance

• VIN mandatory per Slovak VAT Act 2025
• Explain importance: "VIN required for tax deduction eligibility in Slovakia"
• License plate must follow Slovak format

Error Handling

• Duplicate plate: Ask if user wants to update existing vehicle
• Invalid VIN: Show why invalid (length, forbidden characters), ask for correction
• Invalid plate: Show expected format, ask for correction

Related Skills

After successful creation:

• Suggest: "Ready to log your first checkpoint!" (links to checkpoint-from-receipt skill)

---

For detailed examples: See GUIDE.md For MCP tools: See REFERENCE.md