🇷🇺 Русская версия

🚗 Car Maintenance — Service History & Analysis

A Kimi Code CLI skill for end-to-end vehicle maintenance management: from logging service records to predicting upcoming maintenance and tracking shop recommendations.

Features

• Service history — chronological database of all work tied to mileage and date
• Maintenance forecast — automatic scheduling based on manufacturer intervals (mileage OR date — whichever comes first)
• Recommendation tracking — follow-up on open shop recommendations with statuses
• EuroAuto sync — import work orders and recommendations from EuroAuto Garage
• Pattern analysis — detect recurring issues, repeated repairs, and forecast expenses
• VIN decoding — automatic model and configuration lookup via NHTSA API
• Cost estimation — upcoming work estimates with OEM and aftermarket parts

Installation

# Copy into the Kimi skills directory
cp -r car-maintenance-skill ~/.kimi/skills/car-maintenance

# Create the data directory
mkdir -p ~/docs/car-maintenance/vehicles

Quick Start

car add-vehicle          # Register a vehicle by VIN
car add-record           # Add a service record (text / photo / PDF)
car status               # What's overdue, what's coming up
car next-service         # Plan and estimate for the next service

Example

> car add-vehicle
🔍 Enter VIN: WVWZZZ3CZWE123456
✅ Volkswagen Golf 2014, 1.4L TSI, DSG, FWD
   Schedule: references/maintenance-generic.md
   Profile created: ~/docs/car-maintenance/vehicles/WVWZZZ3CZWE123456.md

> car status
🔧 car-maintenance v2.0.0 | data as of 25.06.2026
| Item              | Last replaced | Next due       | Status         |
|-------------------|---------------|----------------|----------------|
| Timing belt       | 03.2021       | 03.2026        | 🔴 OVERDUE     |
| Brake fluid       | 06.2023       | 06.2025        | 🔴 OVERDUE     |
| Engine oil        | 01.2026       | 01.2027        | 🟢 OK          |

Commands

Command	Description
car add-vehicle	Register a vehicle by VIN
car add-record	Add a service record (text, photo, PDF, EuroAuto)
car status	Current status: overdue and upcoming work
car next-service	Detailed plan for the next service with cost estimate and priorities
car history	Full service history
car analyze	Deep analysis: patterns, anomalies, expense forecast
car schedule	Manufacturer maintenance schedule for the vehicle
car euroauto-sync	Sync data from EuroAuto Garage

Data Structure

All data is stored in ~/docs/car-maintenance/. Files with a date suffix (-YYYY-MM-DD) represent the current version as of that date. Older versions are kept as snapshots.

~/docs/car-maintenance/
├── service-history-YYYY-MM-DD.md          # Service history
├── next-service-plan-YYYY-MM-DD.md        # Next service plan
├── euroauto-recommendations-YYYY-MM-DD.md # Shop recommendations with statuses
├── euroauto-orders-YYYY-MM-DD.json        # Raw work order data
├── cost-estimate-*-YYYY-MM-DD.md          # Cost estimates
├── service-schedule-*.md                  # Maintenance schedule (static)
└── vehicles/{VIN}.md                      # Vehicle profile

Skill Structure

car-maintenance/
├── SKILL.md                               # Instructions for Kimi (algorithms, rules)
├── README.md                              # This file
├── references/
│   ├── maintenance-hyundai-tucson-jm.md   # Example: Hyundai Tucson JM schedule
│   ├── maintenance-generic.md             # Generic schedule template
│   └── vin-structure.md                   # VIN reference + API
├── scripts/
│   └── vin-decoder.py                     # VIN decoder (NHTSA API + manual parsing)
└── assets/templates/
    ├── vehicle-profile.md                 # Vehicle profile template
    ├── service-record.md                  # Service record template
    └── analysis-report.md                 # Analysis report template

Adding a Schedule for a New Model

1. Copy references/maintenance-generic.md as a starting point
2. Rename it: references/maintenance-{make}-{model}-{gen}.md
3. Fill in the intervals from the owner's manual or service booklet
4. Add a "Known Issues" section for the model

License

MIT