jlcpcb-check

Analyze footprint and CPL data to correct JLCPCB 3D model alignment.

2|Updated Feb 8, 2026
One-click install
npx skills add https://github.com/pjcau/esp32-emu-turbo --skill jlcpcb-check
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: jlcpcb-check
Source: https://github.com/pjcau/esp32-emu-turbo/tree/main/.claude/skills/jlcpcb-check
Command: npx skills add https://github.com/pjcau/esp32-emu-turbo --skill jlcpcb-check

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps identify and fix JLCPCB 3D model alignment issues for a specific component by comparing footprint data, CPL data, and placement orientation to ensure correct bottom-side soldering and alignment.

Core Features & Use Cases

  • Identify the target component from the BOM and extract reference designator, LCSC part number, and footprint name.
  • Retrieve footprint definitions and placement information from project scripts to determine footprint center and pad coordinates.
  • Analyze CPL data to capture current rotation and layer, and fetch external model orientation information from EasyEDA/jlcpcb resources.
  • Compute and apply rotation and/or position corrections, generate CPL variants for 0/90/180/270 rotations, and propose a recommended fix strategy.
  • Integrate with the PCB tooling to update CPL data and align 3D models with real footprints for reliable assembly.

Quick Start

Provide the target component reference (e.g., U5) and run the analysis to determine the correct CPL rotation and position for JLCPCB placement.

Frequently Asked Questions about jlcpcb-check

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I fix JLCPCB 3D model alignment for bottom-side PCB components?

Fix JLCPCB 3D model alignment by analyzing footprint data, CPL data, and part orientation to compute rotation and position corrections for bottom-side placements. This process compares your project's footprint definitions against external EasyEDA model orientation data to generate corrected CPL variants.

Why does my CPL rotation cause misaligned components on JLCPCB bottom-side placements?

CPL rotation misalignment occurs when footprint data and placement orientation do not match the external EasyEDA 3D model coordinates. Analyzing the BOM reference designator, footprint center, and pad coordinates determines the valid rotation corrections needed to align the 3D model with the real footprint.

What data do I need to generate corrected CPL files for JLCPCB assembly?

Generating corrected CPL files requires scripts/generate_pcb data, matching BOM data, and current CPL data. These inputs identify the target component's LCSC part number and footprint name to compute valid rotation corrections and produce updated CPL variants for 0, 90, 180, and 270 degrees.

Can I automatically calculate rotation and offset corrections for JLCPCB footprints?

Yes, you can automatically calculate rotation and offset corrections by retrieving footprint definitions and placement information from project scripts. The analysis fetches external model orientation information from EasyEDA resources to propose a recommended fix strategy and insert corrections into your PCB tooling.

What is the best way to align JLCPCB 3D models with precision using BOM and CPL data?

The best way to align JLCPCB 3D models with precision is to cross-reference BOM reference designators and footprint names with CPL layer and rotation data. This comparison enables the generation of corrected CPL variants and updates the PCB tooling data for reliable physical assembly.

Are there limitations when correcting JLCPCB footprint alignment for specific component references?

Correcting JLCPCB footprint alignment is limited to components explicitly listed in your BOM and requires matching scripts/generate_pcb data. Without the corresponding footprint definitions and CPL data for the target reference designator, the analysis cannot determine valid rotation corrections or produce updated CPLs.