- Home
- Skills
- Code Quality & Review
- DBC Matrix Audit
Works with the AI Agents you already use
DBC Matrix Audit
Lint, diff and decode CAN / CAN FD DBC matrices with zero dependencies — 11 structural checks, 14 revision-diff codes, CI-ready.
Free
DBC Matrix Audit
Example session with this skill installed
Audit this supplier matrix before we flash it: demo_broken.dbc
Check the encoding first, then lint it. After that decode frame 0x201 with payload 0102030405060708 — I want to see what the two signals in that frame actually read.
- Read your context and instructions
- Compiled the dbc matrix audit
Matrix audit — demo_broken.dbc
Conclusion: do not flash this yet. 4 errors, 4 warnings. The file is
GBK encoded, so it was transcoded to UTF-8 before the comment-dependent checks ran — a clean result on the transcoded copy would not have meant the original was fine.
encoding gbk [not UTF-8]
nodes ACM_A, ACM_B, RCM, RCM_SPARE
messages 20
signals 166
CAN FD frames 12 / 20
Errors (4)
| Code | Frame | What is wrong | Symptom |
|---|---|---|---|
BIT-001 | 0x201 ACM_B_Status | ACM_B_Supply_Voltage and ACM_B_Temperature share 8 bits | Both sides run fine and one value is silently wrong |
DLC-001 | 0x500 Log_Snapshot | DLC 13 is not a legal CAN FD size | Vector may accept it; other tools reject the frame |
ENC-001 | whole file | Not valid UTF-8 (GBK) | Python and CI break; Vector tolerates it and hides the problem |
RNG-001 | 0x500 Log_Snapshot | Log_Word_4 reaches byte 15 in a 13-byte frame | Receiver reads past the payload |
[E] BIT-001 ACM_B_Supply_Voltage and ACM_B_Temperature occupy overlapping bits (0x201 ACM_B_Status)
8 shared bit(s): [(5, 0), (5, 1), (5, 2), (5, 3), (5, 4), (6, 5), (6, 6), (6, 7)]
[E] DLC-001 illegal DLC 13 (0x500 Log_Snapshot)
valid CAN FD payload sizes are 0, 1, 2, 3, 4, 5, 6, 7, 8, 12, 16, 20, 24, 32, 48, 64
Warnings (4)
DUP-001 a signal name reused across frames · ENU-001 enum attribute written as a numeric index · SYM-001 ACM_A_Status has two signals ACM_B_Status lacks · TYP-001 ACM_X_Projection_State vs ACM_X_Projection_statE
[W] SYM-001 ACM_A_Status / ACM_B_Status are not symmetric (0x200 vs 0x201)
ACM_A_Status only: 2 (ACM_X_Projection_Fault, ACM_X_Projection_statE) | ACM_B_Status only: 1
(ACM_X_Projection_State)
[W] TYP-001 same signal spelled differently (beyond the side token)
ACM_X_Projection_State vs ACM_X_Projection_statE
Decoding 0x201 with 0102030405060708
0x201 ACM_B_Status DLC=32 payload=01 02 03 04 05 06 07 08
ACM_B_Checksum = 258
ACM_B_Counter = 3
ACM_B_High_Beam_State = 2 (On)
ACM_B_Adaptive_Light_State = 2 (On)
ACM_B_Supply_Voltage = 4.8 V
ACM_B_Temperature = -16 degC
This is the overlap made visible. 4.8 V supply with the module at −16 °C is not a plausible pair — the two signals are reading the same bits, so each one's value is contaminated by the other's. Nothing in the file says this. Only the bit geometry does.
Next steps
- Give
ACM_B_Supply_VoltageandACM_B_Temperaturedisjoint bits, then re-runlint— expect theBIT-001to clear and the decoded pair to become physically sensible. - Fix the
DLC 13on0x500to a legal size (12 or 16), then re-checkLog_Word_4against the corrected length. - Ship the transcoded UTF-8 file to CI, and keep the GBK original archived — the encoding itself is a defect, not a cosmetic issue.
- Confirm
RCM_SPAREis intentional; an undeclared-but-present node usually means a leftover from a previous variant.
Connects securely to your tools. The creator never sees your data.
About this skill
Automotive DBC matrices break silently. Two signals overlap one bit and both ECUs keep running while the value is wrong. A frame keeps its name but moves to a new CAN id, and routing tables point at an address nothing sends. A checksum's data id changes inside a comment, and the receiver rejects every frame without raising an error.
This skill gives your agent 11 structural lint checks and 14 revision-diff codes to catch those before integration, using one standard-library Python script — no cantools, no pip install, nothing to version-pin.
What it does
- Bit-field overlap — two signals occupying the same bits inside one frame, which compiles cleanly and corrupts values at runtime
- Payload overrun — a signal that extends past the frame's DLC
- Encoding — a GBK matrix that Vector opens fine but that breaks Python and CI
- Left/right asymmetry — one side of the vehicle has a signal the other lacks (L/R, A/B, FL/FR, LH/RH, MFL/MFR)
- Spelling drift — the same signal spelled differently on each side (
AFSFctStvsAFSFctst), so code written against one side silently gets nothing from the other - Version diff — frames added, removed, renamed, resized, retimed; transmitters, cycle times, scaling, ranges, units and value tables changed
- Frame decoding — raw hex payload interpreted against the matrix, with scaled values and enum labels
- Inventory export — full signal list to CSV for suppliers or documentation
Two things a naive diff cannot express
- A frame that keeps its name but moves to a different CAN id is reported as a single id-change, not as one removal plus one addition. The naive reading buries the actual cause under dozens of unrelated lines.
- A checksum data id lives in free text inside a signal comment (
CRC16 checksum (DataID: 0x61D2)), so a structural diff only sees "comment changed". It is extracted and promoted to an error, because a receiver whose checksum fails drops the whole frame — the symptom is silence, not a fault.
How it is used
info— probe message count, signal count, bus load, so a large matrix is never dumped unfilteredlint— structural audit; exits 1 on errors, so it drops straight into CIfix-encodingthenlintagain — a GBK original must be transcoded first, or every comment-dependent check degrades silentlydiff— compare a baseline against a new release, with the baseline firstdecode/export— inspect one frame, or hand the supplier a complete inventory
Verification
61 unit tests. Two synthetic fixtures ship inside the skill so your agent can confirm the tool works before touching a real matrix: one clean matrix, and the same matrix with ten defect classes planted. Both are generated with computed bit placement, so the clean one cannot overlap by construction.
Zero dependencies, MIT licensed, no network calls, no telemetry, no file writes outside the paths you pass in. Source and issue tracker: https://github.com/autosar-skills/autosar-agent-skills
Why not just prompt it
A general model reading a DBC will estimate bit positions and lose track of overlaps once a frame has twenty signals. This skill does the arithmetic in deterministic code and leaves the judgement to the agent, so the findings are computed rather than plausible.
Known limitations
Read-only except the explicit fix-encoding and export commands. DBC only — does not parse ARXML, LDF or KCD. Multiplexed signals are not modelled, so matrices using mux can produce false positives on the overlap check. Symmetry checks are naming heuristics and need frame names of the form X_L_Y / X_R_Y. CRC and rolling-counter algorithms are not verified, only whether they are declared.
Read-only except the explicit fix-encoding and export commands.
DBC only — does not parse ARXML, LDF or KCD.
Multiplexed signals are not modelled, so matrices using mux can produce false positives on the overlap check.
Symmetry checks are naming heuristics and need frame names of the form X_L_Y / X_R_Y.
CRC and rolling-counter algorithms are not verified — only whether they are declared.
How to use
- 1
Connect your agent to the Agensi MCP
Copy the prompt and paste it into Claude, ChatGPT, Cursor or any agent that supports MCP. It sets up the connection for you. Manual setup
- 2
Sign in to Agensi
Your agent shows a sign-in link. Sign in and click Allow.
- 3
Ask for what you need
Your agent loads this skill and uses it on your task. It always asks before any payment.
Reviews
No reviews yet
Be one of the first to try it. Every listed skill goes through the trust checks below.
Security scanned
Checked by our 8-point scan before listing
Fresh listing
Recently published to Agensi
Free forever
No account required to browse
Trust & safety
Security scan
Security scan passed 12 days ago
- Free with an Agensi account
Requires
Permissions
File Scopes