Skip to main content
skill CX Codex

first-contact — Claude Code skill: troubleshooting and installation

The first-contact Claude Code skill diagnoses a scanner that cannot communicate with an engine computer. It activates when an initial reading fails or a previously working setup stops responding.

GPL-3.0 ★ 319 updated 2026-11-10

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add MZULALI/xj-scanner --skill first-contact -a claude-code
Open on GitHub

What first-contact does

first-contact traces the break in communication between a laptop, a Nano board, and the engine computer. It checks the USB connection and bridge first, then the idle signal level, byte echo, and wiring. The sequence stops at the first failed check.

The skill uses .venv/bin/python pc/xj_scan.py --cli auto --codes for the initial test. To inspect the signal directly, it uploads arduino/xj_sniff and runs .venv/bin/python tools/sniff.py. A mismatched echo or implausible readings can point to byte order; the suggested checks use --byte-order swap or normal. Reload arduino/xj_bridge after the sniff test.

The setup needs a Nano, a connection to the engine computer, and Python from .venv; a meter is used to measure the signal level. A line that stays HIGH can result from the key being off, poor contact on wire A, or wires A and B being swapped.

What it helps with

  • locate a failure between the laptop and Nano
  • check the signal level on the communication line
  • diagnose a missing echo from the engine computer
  • identify a byte-order mismatch in readings
  • trace a connection that stopped responding

Example prompts for the agent

  • Find why the scanner's first reading gets no response from the engine computer.
  • Help diagnose a HIGH idle signal and check wires A and B.
  • Trace why the scanner stopped receiving an echo after it worked.

How to install first-contact

1Skills CLI (Vercel)

npx skills add MZULALI/xj-scanner --skill first-contact -a claude-code

2Manually: put the files in place

~/.claude/skills/first-contact/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/first-contact/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about first-contact

How do I install first-contact in Claude Code?

Run npx skills add MZULALI/xj-scanner --skill first-contact -a claude-code. The skill file is at ~/.claude/skills/first-contact/SKILL.md.

What does first-contact do?

It checks the USB link to the Nano, signal level, byte echo, and wiring in sequence to locate communication faults with the engine computer.

What does first-contact need to work?

It needs a Nano, a connection to the engine computer, and Python from .venv. A meter is used to measure the signal level.

Similar skills

All skills for Testing and QA →

From the same set3

Project sponsors

Companies that keep this analytics open