Repolode
Submit
John-owo

John-owo/pcb-agent-workflow

A workflow kit for designing PCBs in KiCad 10 with Claude Code or Codex and ordering them from JLCPCB, with docs, templates and skills.

View on GitHub
Stars
72
Forks
10
Open issues
0
Last commit
7 days ago

What is it?

pcb-agent-workflow is a set of documents, project templates and agent skills for taking a PCB from schematic design through review, JLCPCB quoting, order submission, customer-support exchanges and production-file verification. It targets developers who use Claude Code or Codex alongside KiCad 10 and want a repeatable process for hardware boards.

The repository includes a getting-started guide, a pre-fabrication checklist, a glossary of PCB manufacturing terms, and rules for multiple agents sharing one project directory, such as a single writer, a WORKLOG file and frozen release packages with hash manifests. Four skills cover JLC support correspondence with deadline calculation, comparing factory CAM output against original Gerbers, readable schematic and layout drawing with netlist checks, and exporting a board to a STEP file with all components for enclosure design.

A worked example is a 4-layer GNSS breakout board built around the u-blox MAX-M10S, including KiCad source, Gerbers, BOM, CPL and test records. Skills are installable as Claude Code or Codex plugins or copied manually. The project is validated on Windows with KiCad 10 and JLCPCB; other platforms and board houses are not tested.

Key features

  • 01Step-by-step guide from installing KiCad to placing a JLCPCB order
  • 02Pre-fabrication checklist usable by both people and agents
  • 03JLC support skill with six reply templates and deadline calculation script
  • 04Layer-by-layer comparison of factory CAM output against original Gerbers
  • 05Readable schematic layout skill with netlist and pin-to-pad verification scripts
  • 06Board-to-STEP export with component placement checks for enclosure design

Use cases

  • Designing and ordering a first small PCB with an AI coding agent
  • Checking a factory's production files before approving manufacture
  • Drafting follow-up emails to a PCB fabricator's support or engineering team
  • Producing an enclosure model from a KiCad board

Quick start

  1. 1

    Clone the repository

    git clone https://github.com/John-owo/pcb-agent-workflow.git
  2. 2

    Read the getting-started guide in docs/getting-started.md

  3. 3

    In Claude Code, add the plugin marketplace

    /plugin marketplace add John-owo/pcb-agent-workflow
  4. 4

    In Claude Code, install the jlc-support plugin

    /plugin install jlc-support@pcb-agent-workflow

Things to know

  • Only validated on Windows with KiCad 10 and JLCPCB; other platforms and fabs are unverified.
  • Requires both Claude Code and Codex to be usable for full support, and the Claude Code send-guard hook is not verified on Codex.
  • JLCPCB deadlines, prices and parts availability are observations from 2026-09 and may be outdated.
  • Some helper scripts require Python 3.12 and CadQuery, adding setup effort.

In collections

Skill packs for Claude Code and CodexClaude Code tools, skills & pluginsAI coding assistants & agentsAI agent skill libraries

Topics

#pcb#kicad#jlcpcb#claude-code#codex#hardware#agent-skills#electronics

FAQ

What is pcb-agent-workflow?
A workflow kit for designing PCBs in KiCad 10 with Claude Code or Codex and ordering them from JLCPCB, with docs, templates and skills. pcb-agent-workflow is a set of documents, project templates and agent skills for taking a PCB from schematic design through review, JLCPCB quoting, order submission, customer-support exchanges and production-file verification. It targets developers who use Claude Code or Codex alongside KiCad 10 and want a repeatable process for hardware boards.
Is pcb-agent-workflow free to use? What license does it have?
pcb-agent-workflow is open source under the MIT license. Check the license terms before using it in commercial products.
Is pcb-agent-workflow still maintained?
Actively maintained. The last commit to pcb-agent-workflow was on Oct 30, 2026.
What can I use pcb-agent-workflow for?
Designing and ordering a first small PCB with an AI coding agent Checking a factory's production files before approving manufacture Drafting follow-up emails to a PCB fabricator's support or engineering team Producing an enclosure model from a KiCad board
How do I install pcb-agent-workflow?
Clone the repository: git clone https://github.com/John-owo/pcb-agent-workflow.git Read the getting-started guide in docs/getting-started.md In Claude Code, add the plugin marketplace: /plugin marketplace add John-owo/pcb-agent-workflow In Claude Code, install the jlc-support plugin: /plugin install jlc-support@pcb-agent-workflow
Where can I get pcb-agent-workflow?
The source code and installation instructions are on GitHub: https://github.com/John-owo/pcb-agent-workflow

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects