Skip to content
Back to search

can-bus-reverse-engineering-skills

Claude Code skills for reverse-engineering CAN bus signals into DBC files using the CANsub CAN bus interface

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/CSS-Electronics/can-bus-reverse-engineering-skills with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/CSS-Electronics/can-bus-reverse-engineering-skills'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/css-electronics--can-bus-reverse-engineering-skills/badge.svg)](/listings/css-electronics--can-bus-reverse-engineering-skills)

HTML

<a href="/listings/css-electronics--can-bus-reverse-engineering-skills"><img src="/api/listings/css-electronics--can-bus-reverse-engineering-skills/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

The below is our recommended setup for new Claude Code users:

1. **Get a [Claude subscription](https://claude.ai)** - Claude Code is included with [Claude Pro / Max](https://www.claude.com/claude-code) (or API billing) 2. **Install [Visual Studio Code](https://code.visualstudio.com)** 3. **Install the Claude Code extension** - Extensions panel (`Ctrl+Shift+X`), search **"Claude Code"**, install, sign in 4. **Open this folder** - *File → Open Folder…* → the cloned repo; skills in `.claude/skills/` load automatically

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 105 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # CAN bus reverse engineering skills
  2. This repo contains [Claude Code](https://www.claude.com/claude-code) skills that help you reverse engineer raw CAN bus data into decoding rules stored as DBC files.
  3. Specifically, the skills help you leverage AI/LLM tools like Claude Code and [python-can](https://www.csselectronics.com/pages/python-can-usb-serial-api-stream) scripts to identify which CAN ID and data bits encode a
  4. real-world value (speed, RPM, state of charge, ...), work out its start bit,
  5. length, endianness, scale and offset, and verify the result.
  6. The skills assume that you are using a [CANsub](https://www.csselectronics.com/products/can-fd-usb-interface-ethernet-cansub-2) CAN bus interface from [CSS Electronics](https://www.csselectronics.com) to either record CSV log files via e.g. the [webCAN](https://www.csselectronics.com/pages/webcan-can-bus-streaming-software-browser) tool, or stream data in real-time via USB/Ethernet.
  7. The repo bundles three skills (auto-discovered when you open the folder in Claude
  8. Code):
  9. - **cansub-reverse-engineering** - the workflow
  10. - **combine-dbc** - merge per-signal DBCs into one
  11. - **cansub-knowledge** - CANsub specs / API reference
  12. <br>
  13. **Note:** This is not a 'polished tool', but an illustration of how you can use the CANsub + Python + AI for CAN sniffing
  14. **Note:** We strongly recommend reading our related article [CAN bus reverse engineering with AI](https://www.csselectronics.com/pages/can-bus-reverse-engineering-ai-llm-claude).
  15. [![Watch the CAN bus reverse engineering demo](docs/vision-reference-demo.png)](https://cdn.shopify.com/videos/c/o/v/e384c5a75b7943e681dcbad2d10e230a.mp4)
  16. ## Recommended hardware
  17. - A [CANsub.2](https://www.csselectronics.com/products/can-fd-usb-interface-ethernet-cansub-2) CAN FD interface with USB/Ethernet
  18. - An [OBD2-DB9 adapter cable](https://www.csselectronics.com/products/obd2-db9-adapter-cable) (and optionally a [contactless adapter](https://www.csselectronics.com/products/contactless-can-bus-reader-adapter))
  19. <img src="https://www.csselectronics.com/cdn/shop/files/CANsub-can-bus-interface-stream-real-time-webcan.png" alt="CANsub CAN bus interface streaming real-time in webCAN" width="25%"> <img src="https://www.csselectronics.com/cdn/shop/products/OBD2-DB9-Adapter-Cable-CAN-Bus.jpg?v=1625644186" alt="OBD2-DB9 adapter cable" width="20%">
  20. ## 1. Get the code and install dependencies
  21. 1. **Clone the repo** (or download the ZIP from GitHub and extract it)
  22. 2. **Install Python** - [Python 3.10+](https://www.python.org/downloads/); on Windows, tick **"Add python.exe to PATH"**. Verify: `python --version`
  23. 3. **Install the dependencies** into a local virtual environment (`.venv`) so your system Python stays untouched:
  24. - **Windows:** double-click **`install.bat`** (or run `install.bat` in a terminal)
  25. - **macOS / Linux:** `python3 -m venv .venv && .venv/bin/pip install -r requirements.txt`
  26. ## 2. Set up Claude Code
  27. The below is our recommended setup for new Claude Code users:
  28. 1. **Get a [Claude subscription](https://claude.ai)** - Claude Code is included with [Claude Pro / Max](https://www.claude.com/claude-code) (or API billing)
  29. 2. **Install [Visual Studio Code](https://code.visualstudio.com)**
  30. 3. **Install the Claude Code extension** - Extensions panel (`Ctrl+Shift+X`), search **"Claude Code"**, install, sign in
  31. 4. **Open this folder** - *File → Open Folder…* → the cloned repo; skills in `.claude/skills/` load automatically
  32. ## 3. Connect the hardware
  33. Plug the CANsub into your computer (USB) and into the vehicle's OBD2 port using the
  34. OBD2-DB9 adapter cable. Start the engine (or set the ignition on) so there's live
  35. CAN traffic to capture. We recommend verifying via [webCAN](https://www.csselectronics.com/pages/webcan-can-bus-streaming-software-browser) that you can stream raw proprietary CAN bus data before proceeding. If not, consider our [contactless CAN reader](https://www.csselectronics.com/products/contactless-can-bus-reader-adapter).
  36. ## Try it
  37. Open the Claude Code panel in VS Code and ask, for example:
  38. > I've connected my CANsub to my car via the OBD2-DB9 cable. Help me check if there is live proprietary CAN data available - and then help me reverse engineer my door locks
  39. > Reverse engineer Speed and RPM from the proprietary CAN data found in Mercedes-E350-2010-obd2-can.csv (contains OBD2 reference data).
  40. > I have a CANedge log with proprietary vehicle CAN data plus the CANedge's internal GPS/IMU on CAN9 (or a CANmod.gps GPS-to-CAN module). Use the GPS speed as the reference to reverse engineer the proprietary vehicle speed
  41. > Help me reverse engineer Speed from my Opel Astra. I have put the raw CAN data in opel/ along with a video of the speed from my car's dashboard.
  42. > I have a gauge-to-CAN module with 8 gauges connected to my CANsub - help me reverse engineer the 1st gauge position signal.
  43. **Note:** You can use our [CANsub CAN+OBD2 sample data](https://www.csselectronics.com/pages/ai-can-bus-sniffer-data-pack) to test the skill
  44. **Note:** You should NOT attach a CSV as an attachment to Claude - it'll attempt to load possibly millions of raw CAN frames into the context window. Instead reference the CSV file path
  45. ## Output structure and combining DBCs
  46. Each confirmed signal is saved under `decoding-output/`, grouped by application
  47. (the system under test) and signal:
  48. ```
  49. decoding-output/
  50. <application>/ e.g. mercedes-e350/
  51. <signal>/<signal>.dbc e.g. engine-rpm/engine-rpm.dbc (one DBC per signal)
  52. <signal>/<signal>.png the verify plot (decoded vs reference)
  53. <signal>/analysis-plots/ survey / correlate / bit-search / fit plots
  54. <application>.dbc the combined DBC across all signals
  55. ```
  56. If you've decoded several signals, ask Claude to merge them into one
  57. application DBC (using the **combine-dbc** skill):
  58. > Combine the decoded DBCs for mercedes-e350 into a single DBC.
  59. This produces `decoding-output/<application>/<application>.dbc`. You can load
  60. this combined DBC in [webCAN](https://www.csselectronics.com/pages/webcan-can-bus-streaming-software-browser)
  61. and stream live from your CANsub to see your reverse-engineered signals decoded in
  62. real time - a final, live confirmation of the results.
  63. ## License and attribution
  64. These skills are fully open source under the [MIT License](LICENSE) - you are free to use, modify and distribute them in your own projects.
  65. If you use them in your projects, videos or blog posts, we'd appreciate a reference to our article: [CAN bus reverse engineering with AI](https://www.csselectronics.com/pages/can-bus-reverse-engineering-ai-llm-claude).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.