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
npx skills add MZULALI/xj-scanner --skill first-contact -a claude-codeWhat 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-code2Manually: put the files in place
~/.claude/skills/first-contact/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/first-contact/
1Skills CLI (Vercel)
npx skills add MZULALI/xj-scanner --skill first-contact -a codex2Manually: put the files in place
.agents/skills/first-contact/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add MZULALI/xj-scanner --skill first-contact -a cursor2Manually: put the files in place
.cursor/skills/first-contact/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install MZULALI/xj-scanner .claude/skills/first-contact2Manually: put the files in place
.github/skills/first-contact/SKILL.md1Skills CLI (Vercel)
npx skills add MZULALI/xj-scanner --skill first-contact -a gemini-cli2Platform CLI
gemini skills install https://github.com/MZULALI/xj-scanner --path .claude/skills/first-contactManually: put the files in place
.devin/skills/first-contact/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
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.