# scan

A Claude Code skill reads fault codes and live engine data from a Jeep computer. It records a drive and summarizes the log once the scanner connection works.

- 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/scan/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/mzulali-scan

## What it does

The skill runs tools that read a Jeep engine computer, capture fault codes and live values, and save drive data as CSV. It can summarize a log after the scanner is connected and someone wants to inspect the engine.

Run `pc/xj_scan.py` from the repository root with the virtual environment’s Python; `auto` locates the Nano. Supporting tools summarize logs, report a drive by speed, or list parameters that respond. Read `docs/parameters.md` before interpreting values: fuel trim and speed readings need correction for this computer. A drive log covers only the speed and load recorded during that trip.

Erasing codes also clears learned fuel trim. Actuator tests can activate the fuel pump, injectors, or coils, so get consent before running them; the tests require the key on and engine off.

## Install

### Claude Code (native platform)

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

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

### Codex

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

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

### Cursor

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

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

### GitHub Copilot

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

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

### Gemini CLI

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

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

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/scan/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/scan/SKILL.md

## When to use it
- read engine fault codes from a Jeep computer
- record engine parameters during a drive
- summarize a trip log and O2 behavior
- list the computer’s responding parameters
- break down a drive log by speed

## Example prompts
- Read the fault codes from the Jeep engine computer.
- Record the engine data during my drive; I’ll stop it with Ctrl+C.
- Summarize `pc/logs/xj_XXXX.csv`.

## Similar
- [security-scan](https://affpapa.org/en/nevibecode/skills/affaan-m-security-scan.md) — skill · 6500 installs
- [repo-scan](https://affpapa.org/en/nevibecode/skills/repo-scan.md) — skill · 6200 installs
- [ghost-scan-code](https://affpapa.org/en/nevibecode/skills/ghost-scan-code.md) — skill · 5700 installs
- [ghost-scan-secrets](https://affpapa.org/en/nevibecode/skills/ghost-scan-secrets.md) — skill · 4900 installs
- [dx-apexguru-scan](https://affpapa.org/en/nevibecode/skills/dx-apexguru-scan.md) — skill · 2900 installs
- [build-wireframe-scan-reveal](https://affpapa.org/en/nevibecode/skills/build-wireframe-scan-reveal.md) — skill · 1500 installs

## Other versions with the same name
- [scan · wshobson](https://affpapa.org/en/nevibecode/skills/scan.md) — 4600 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
