# first-contact

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.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 319 repo stars
- Author: MZULALI
- License: GPL-3.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/MZULALI/xj-scanner/tree/HEAD/.claude/skills/first-contact/SKILL.md
- Updated: 2026-11-10
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/first-contact

## What it 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.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add MZULALI/xj-scanner --skill first-contact -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/first-contact/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/first-contact/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add MZULALI/xj-scanner --skill first-contact -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/first-contact/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add MZULALI/xj-scanner --skill first-contact -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/first-contact/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install MZULALI/xj-scanner .claude/skills/first-contact
```

2. **Manually: put the files in place**
- File: `.github/skills/first-contact/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add MZULALI/xj-scanner --skill first-contact -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/MZULALI/xj-scanner --path .claude/skills/first-contact
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/first-contact/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/MZULALI/xj-scanner/tree/HEAD/.claude/skills/first-contact/SKILL.md

## When to use it
- 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
- 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.

## Similar
- [s800-vehicle-network-security-testing](https://affpapa.org/en/nevibecode/skills/s800-vehicle-network-security-testing.md) — skill · 728 installs
- [investigate-first](https://affpapa.org/en/nevibecode/skills/investigate-first.md) — skill · 129600 installs
- [circuit-debugger](https://affpapa.org/en/nevibecode/skills/circuit-debugger.md) — skill · 298 installs
- [i2c-bringup-diagnostician](https://affpapa.org/en/nevibecode/skills/i2c-bringup-diagnostician.md) — skill · 134 installs
- [ai-first-engineering](https://affpapa.org/en/nevibecode/skills/ai-first-engineering.md) — skill · 6300 installs
- [eval-harness-first](https://affpapa.org/en/nevibecode/skills/eval-harness-first.md) — skill · 2600 installs

From the same set: [mzulali/xj-scanner](https://affpapa.org/en/nevibecode/by/mzulali/xj-scanner.md) — 3 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
