🚗 Automotive AI Skills

An open-source collection of AI skills for automotive diagnostics, maintenance, repair, customization, and vehicle ownership — for beginners and experienced mechanics alike.

English

日本語

Español

📖 Browse as a website: shoka-jp.github.io/automotive-ai-skills

Try it with your vehicle

Open the Vehicle Brief Builder → · Try an N-BOX buying brief · 日本語

Choose a vehicle and goal: buying, symptoms, recall records, maintenance, estimates or selling.
Read the relevant questions and references, filtered by model code, production year and original market.
Copy the prompt into your preferred AI, save Markdown, or print the brief.

No account, API key or adapter. Inputs are not sent or saved; shared links contain only the preset vehicle and goal. The builder does not run an AI diagnosis or an official eligibility lookup.

Seven source-reviewed entries support eight Japan-market profiles. Other vehicles can use the general workflow; the full library has 17 entries. Quality and limits · Request a vehicle

If this helps your next viewing or workshop visit, Star the repository to find it again and support its development. Documented findings and corrections are welcome.

Overview

Large language models are genuinely useful in the garage — but only when prompted with structure, context, and awareness of their limits. This repository packages that structure as skills: curated prompt frameworks, workflows, and guardrails that turn a general-purpose AI assistant into a focused automotive helper.

Each skill defines:

What it can do (capabilities, with honest limitations)
How to use it (recommended workflow and context to provide)
Ready-to-use example prompts you can copy and adapt

The skills are platform-agnostic: they work with Claude, ChatGPT, local models, or any capable AI assistant. Use the browser builder or copy a skill directly; no code is required for either.

Features

🔧 20 focused skills covering diagnostics, repair, maintenance, buying, customization, EVs, diesels, classics, fleets, tires, trucks, bodywork, towing, car audio, motorcycles, service intake, estimates, listings, and recalls
📋 Structured workflows that gather the right vehicle context before advising
⚠️ Safety-first design — every skill states its limitations and defers safety-critical work appropriately
🧩 Composable — skills hand off to each other (troubleshoot → diagnose → repair → maintain)
🌍 Platform-agnostic — usable with any capable AI assistant, no installation required
📖 Beginner-friendly and expert-useful — workflows scale from first oil change to head gasket jobs
🤝 Contribution-ready — clear authoring guide and templates for new skills

Skills

Skill	What it does
🔧 Mechanic Assistant	Repair procedures, torque specs, tools, and system explanations
🔌 OBD-II Diagnostic Assistant	Interprets trouble codes, freeze frame, and live sensor data
📅 Vehicle Maintenance Planner	Personalized preventive maintenance schedules and budgets
🔍 Used Car Inspector	Pre-purchase checklists, red flags, and negotiation support
🩺 Vehicle Troubleshooting	Symptom-first diagnosis: noises, leaks, vibrations, warning lights
🏁 Vehicle Customization Advisor	Modification planning, fitment math, build order, legality flags
⚡ EV Assistant	Charging strategy, battery health, range, EV-specific maintenance
🏍️ Motorcycle Mechanic	Two-wheeled maintenance, carbs and EFI, valves, suspension setup
🛢️ Diesel Specialist	Common rail, DPF/EGR/SCR aftertreatment, glow plugs, turbos
🕰️ Classic Car Restorer	Points ignition, carburetors, rust assessment, parts sourcing
🚛 Fleet Manager	Multi-vehicle scheduling, cost tracking, downtime planning
🛞 Tire & Wheel Advisor	Sizing math, fitment, seasonal strategy, wear diagnosis, TPMS
🚚 Commercial Vehicle & Truck Assistant	Air brakes, pre-trip inspections, load securing, weight awareness
🎨 Body & Paint Assistant	Dent/scratch assessment, repair paths, paint matching, DIY limits
🪝 Towing & Trailer Advisor	Hitches, tongue weight, trailer wiring and brakes, sway prevention
🔊 Car Audio & Electronics Assistant	Head units, amps, dash cams, 12V wiring discipline, CAN-bus limits
📝 Service Intake Assistant	Turn customer symptoms into an evidence-labeled intake note, focused follow-up questions, and a technician handoff.
🧾 Repair Estimate Reviewer	Compare repair estimates by scope, diagnostic evidence, parts, labor, arithmetic, and questions to resolve before authorization.
🏷️ Used Car Listing Assistant	Draft used-vehicle listings from documented specifications, condition disclosures, and an explicit price breakdown without unsupported claims.
📣 Vehicle Recall Checker	Guide official recall lookups, separate model-level notices from vehicle applicability, and document completion evidence or unknown status.

Not sure which one? See the “Which skill do I need?” guide.

🇯🇵 All skills are also available in Japanese — open the README.ja.md in each skill folder, or start from the Japanese README. Japan-specific guides (shaken inspection checklist, market notes) live in docs/ja/.

Try the companion tool: car-free OBD-II MCP demo — commands, captured simulated output and limitations.

Installation

No installation is required to read and use the skills — browse skills/ or the website. For deeper integration:

Claude Code (plugin — recommended)

The repository is a Claude Code plugin marketplace. Inside Claude Code:

/plugin marketplace add shoka-jp/automotive-ai-skills
/plugin install automotive-ai-skills@automotive-ai-skills

All 20 skills install as native skills (SKILL.md in each skill folder) and trigger automatically when you ask automotive questions.

OpenAI Codex

AGENTS.md is picked up automatically when you run codex inside a clone of this repo. For global setup or per-skill slash commands, see the Codex guide.

Read your actual car: obd2-mcp 🔌

These skills are the knowledge layer. The companion obd2-mcp MCP server is the tool layer — it lets the AI read real trouble codes, live data, and freeze frames from your car through a cheap ELM327 adapter (a mock vehicle is included, so no hardware is needed to try it):

Build from source and try the mock vehicle

Everything else

git clone https://github.com/shoka-jp/automotive-ai-skills.git

Claude Projects / Custom GPTs: paste a skill’s README into the project instructions or system prompt — see the Claude Project template.
API applications / agent frameworks: use each skill’s skill.yaml for routing metadata and the README as the knowledge payload.

Usage

Pick a skill that matches your situation (see the table above).
Read its Recommended Workflow — each skill tells you what context to gather (vehicle details, symptoms, measurements).
Copy an example prompt and adapt it with your vehicle’s details.
Work iteratively. Report findings back; the workflows are designed as conversations, not one-shot questions.
Respect the limitations section. Verify safety-critical specs against factory documentation, and defer high-risk work to professionals.

Quick example

You: My 2015 Honda Civic shows code P0420. Does this always mean the catalytic converter is bad? What should I test before replacing it?

Assistant: Not necessarily — P0420 means the catalyst efficiency test failed, and the converter is only one possible cause. Before spending $1,000+ on a converter, check: (1) the downstream O2 sensor’s response, (2) exhaust leaks ahead of the sensor, (3) stored misfire or fuel-trim codes that could damage the readings… (continues with a test sequence)

Repository Structure

automotive-ai-skills/
├── README.md                 # This file
├── README.ja.md              # Japanese translation
├── LICENSE                   # MIT
├── CONTRIBUTING.md           # How to contribute
├── CODE_OF_CONDUCT.md        # Contributor Covenant v2.1
├── CHANGELOG.md              # Version history
├── SECURITY.md               # Security policy
├── docs/
│   ├── getting-started.md    # New-user walkthrough
│   ├── skill-authoring-guide.md  # How to write a new skill
│   ├── safety-disclaimer.md  # Full safety and liability notes
│   ├── faq.md                # Frequently asked questions
│   └── ja/                   # Japan-specific guides (shaken checklist, market notes)
├── data/
│   └── known-issues/         # Community model-specific known-issue entries
├── examples/                 # Full example conversations (EN + JA)
│   ├── README.md
│   ├── obd2-p0420-diagnosis.md       (+ .ja.md)
│   ├── used-car-inspection.md        (+ .ja.md)
│   └── maintenance-catchup-plan.md   (+ .ja.md)
├── integrations/             # Claude Project template, combined system prompt
└── skills/                   # 20 skills; each folder has README.md,
    ├── README.md             #   README.ja.md, SKILL.md, and skill.yaml
    ├── mechanic-assistant/
    ├── obd2-diagnostic-assistant/
    ├── vehicle-maintenance-planner/
    ├── used-car-inspector/
    ├── vehicle-troubleshooting/
    ├── vehicle-customization-advisor/
    ├── ev-assistant/
    ├── motorcycle-mechanic/
    ├── diesel-specialist/
    ├── classic-car-restorer/
    ├── fleet-manager/
    ├── tire-wheel-advisor/
    ├── commercial-vehicle-assistant/
    ├── body-paint-assistant/
    ├── towing-trailer-advisor/
    ├── car-audio-electronics/
    ├── service-intake-assistant/
    ├── repair-estimate-reviewer/
    ├── used-car-listing-assistant/
    └── vehicle-recall-checker/

Example Conversations

Full annotated conversations live in examples/:

Roadmap

Have an idea? Open an issue with the enhancement label.

Contributing

Contributions are welcome — new skills, improvements to existing ones, corrections, translations, and example conversations. Please read:

CONTRIBUTING.md — process, style guide, and PR checklist
Skill Authoring Guide — required structure for new skills
CODE_OF_CONDUCT.md

Good first contributions: fixing inaccuracies, adding example prompts, and expanding the FAQ.

Support the project

If these skills help with your automotive workflow:

Follow shoka-jp for related automotive AI projects.
Star this repository to bookmark it, or share a skill with someone who could use it.
Help improve the examples, correct inaccuracies, or contribute a translation using the contribution guide.
Sponsor the maintainer to support this open-source work.

Safety Disclaimer

These skills provide general automotive information, not professional advice. Vehicle work involves safety-critical systems. Always verify specifications against factory documentation, and defer brake, steering, airbag (SRS), fuel, and high-voltage work to qualified professionals when in doubt. See the full safety disclaimer.