Revise PCB Assembly Placements in Codex with an Exact Preview

Preview a single placement correction in a revision-bound local PCBA project, review the exact change, and verify the regenerated assembly data after applying it.

中文

Setup for Codex

Use the PCBA Engineering plugin in Codex with Node.js 22.19 or newer. Work on a disposable review project with a supplied authoritative placement snapshot. The pinned fixture already includes it.

Fetch the fixed community-plugins commit linked below. Register that local checkout with codex plugin marketplace add /absolute/path/to/community-plugins, then install pcba-engineering@community-plugins from the local marketplace.
Reload Codex plugin discovery, confirm the requested skill appears, and use a fresh directory under a practice project. A Node.js version of at least 22.19 is required by the package.

Example task

Import the repository's sparkfun-stcc4/missing-u3.json fixture into a disposable directory using $review-pcba-package. Ask $revise-pcba-assembly to preview restoring only U3 from the supplied authoritative placements. Read the returned plan, apply it in the practice directory, then run check with the returned revision.

Expected result

The plan adds only U3. The practice project keeps r1 and creates a new revision with 11 placements and zero blocking errors. Five source or material warnings remain visible, and the original JSON fixture remains unchanged.

Upstream documentation

Original SKILL.md on GitHub · Apache-2.0 license · Source reviewed 2026-11-15

Frequently asked question

Where does a missing placement get its coordinates?

The revision derives coordinates from the supplied authoritative placement data. If that evidence is missing, the change stays unresolved until an authoritative export is available.