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:
License Plate (Slovak format: XX-123XX, e.g., BA-456CD)
- Validate format: 2 letters + hyphen + 3 digits + 2 letters
- Example: "BA-789XY"
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"
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
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
1---2name: vehicle-setup3description: Guide users through Slovak VAT Act 2025 compliant vehicle registration with VIN validation4---5
6# Vehicle Setup Skill
7
8## Purpose
9Guide users through Slovak VAT Act 2025 compliant vehicle registration with VIN validation.
10
11## When to Activate
12- Trigger words: "add vehicle", "register car", "new vehicle"
13- License plate patterns: "BA-*", "*-123*"
14- Vehicle brands: "Ford", "BMW", "Škoda"
15
16## Instructions
17
18### Step 1: Collect Mandatory Fields
19Ask conversationally for:
20
211. **License Plate** (Slovak format: XX-123XX, e.g., BA-456CD)
22 - Validate format: 2 letters + hyphen + 3 digits + 2 letters
23 - Example: "BA-789XY"
24
252. **VIN** (17 characters, no I/O/Q - mandatory for Slovak VAT Act 2025)
26 - Validate: exactly 17 characters, no I/O/Q letters
27 - If invalid: "VIN cannot contain letters I, O, or Q. Please verify."
28 - Explain: "VIN is required for tax deduction eligibility in Slovakia"
29
303. **Fuel Type** (Diesel, Gasoline 95/98, LPG, Hybrid, Electric)
31 - Suggest typical efficiency: Diesel 8.5 L/100km, Gasoline 9.5 L/100km
32 - Always use L/100km format (European standard), never km/L
33
344. **Current Odometer** (kilometers)
35 - Validate: > 0, < 1,000,000 km
36 - Ask: "What's the current odometer reading in kilometers?"
37
38### Step 2: Show Summary & Confirm
39Present clear summary before creating:
40
41```
42Summary:
43• Name: Ford Transit Delivery Van
44• Plate: BA-789XY
45• VIN: WVWZZZ3CZDP123456
46• Fuel: Diesel (avg 8.5 L/100km)
47• Odometer: 125,000 km
48
49Create this vehicle? (yes/no)
50```
51
52### Step 3: Create Vehicle
53- Call MCP tool: `car-log-core.create_vehicle`
54- Request: { name, license_plate, vin, fuel_type, make, model, year, initial_odometer_km }
55- Success: "✅ [Vehicle name] registered! Ready to track trips."
56- Error: Explain issue, offer to retry
57
58## Validation Rules
59- **VIN:** Must match `^[A-HJ-NPR-Z0-9]{17}$` (no I, O, Q)
60- **License Plate:** Must match `^[A-Z]{2}-[0-9]{3}[A-Z]{2}$`
61- **Fuel Efficiency:** Always L/100km (European standard), never km/L
62
63## Slovak Compliance
64- VIN mandatory per Slovak VAT Act 2025
65- Explain importance: "VIN required for tax deduction eligibility in Slovakia"
66- License plate must follow Slovak format
67
68## Error Handling
69- **Duplicate plate:** Ask if user wants to update existing vehicle
70- **Invalid VIN:** Show why invalid (length, forbidden characters), ask for correction
71- **Invalid plate:** Show expected format, ask for correction
72
73## Related Skills
74After successful creation:
75- Suggest: "Ready to log your first checkpoint!" (links to checkpoint-from-receipt skill)
76
77---
78
79**For detailed examples:** See GUIDE.md
80**For MCP tools:** See REFERENCE.md
majiayu000