pcb-skill
Agent skill for taking a hardware idea to a manufacturable PCB: concept, schematic, sourcing, layout, routing, verification, and a purchase staged to the pre-payment page. Drives EasyEDA Pro over MCP from Claude Code or Codex.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/daishuge--pcb-skill)HTML
<a href="/listings/daishuge--pcb-skill"><img src="/api/listings/daishuge--pcb-skill/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
`SKILL.md` loads `references/`, `scripts/` and `setup/` as its own siblings, so all three have to land in the skill directory. This repo keeps `scripts/` and `setup/` at the top level so they stay browsable here — copying only `skills/pcb/` gives you a skill whose checkers and setup guides are simply absent.
git clone https://github.com/daishuge/pcb-skill.git cd pcb-skill DEST=~/.claude/skills/pcb # Codex: DEST=~/.codex/skills/pcb mkdir -p "$DEST" && cp -R skills/pcb/. scripts setup "$DEST"/ # verify — a missing directory here fails later, in the middle of a design ls "$DEST"/SKILL.md "$DEST"/references "$DEST"/scripts "$DEST"/setup >/dev/null && echo "pcb installed"
Then work through [`setup/README.md`](setup/README.md) — the skill checks these before it starts:
1. **EasyEDA Pro + the MCP bridge** — [`setup/easyeda-mcp.md`](setup/easyeda-mcp.md) 2. **A browser with the agent extension, logged in** to your PCB house and your parts suppliers — [`setup/browser-logins.md`](setup/browser-logins.md) 3. **An approval watcher**, if your desktop raises a permission card for every browser action — [`setup/auto-approve-macos.md`](setup/auto-approve-macos.md) · [`setup/auto-approve-windows.md`](setup/auto-approve-windows.md). **Carts and payment stay manual on purpose** — the watcher never touches them.
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 103 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- # PCB skill
- An agent skill for taking a hardware idea all the way to **a board you can order, solder and bring up** —
- concept, schematic, sourcing, layout, routing, verification, and a purchase staged to the pre-payment page.
- It runs inside **Claude Code (desktop)** or **Codex (desktop)**, drives **EasyEDA Pro over MCP**, and does
- its shopping in a browser you are already logged in to.
- > This is not a tutorial about PCB theory. It is the set of gates that catch the things theory does not:
- > a socket rotated so the display can never be plugged in, a capacitor under a module body, a keep-out that
- > exists only on a drawing layer, a checker quietly measuring the previous release. Every rule here was paid
- > for on a real board — see [`docs/case-study.md`](docs/case-study.md).
- ## The three principles
- | | |
- |---|---|
- | **性价比** cost-effectiveness | every part priced from a live page or labelled an estimate; the BOM netted against stock you already own |
- | **好装配** assemblable by hand | you are the assembler — no bottom-terminated packages, every pad reachable, a soldering order that does not trap a joint |
- | **免费 PCB** a free prototype | design inside the free-prototype envelope from the first sketch, not at the end |
- ## Install
- `SKILL.md` loads `references/`, `scripts/` and `setup/` as its own siblings, so all three have to land
- in the skill directory. This repo keeps `scripts/` and `setup/` at the top level so they stay browsable
- here — copying only `skills/pcb/` gives you a skill whose checkers and setup guides are simply absent.
- ```bash
- git clone https://github.com/daishuge/pcb-skill.git
- cd pcb-skill
- DEST=~/.claude/skills/pcb # Codex: DEST=~/.codex/skills/pcb
- mkdir -p "$DEST" && cp -R skills/pcb/. scripts setup "$DEST"/
- # verify — a missing directory here fails later, in the middle of a design
- ls "$DEST"/SKILL.md "$DEST"/references "$DEST"/scripts "$DEST"/setup >/dev/null && echo "pcb installed"
- ```
- Then work through [`setup/README.md`](setup/README.md) — the skill checks these before it starts:
- 1. **EasyEDA Pro + the MCP bridge** — [`setup/easyeda-mcp.md`](setup/easyeda-mcp.md)
- 2. **A browser with the agent extension, logged in** to your PCB house and your parts suppliers —
- [`setup/browser-logins.md`](setup/browser-logins.md)
- 3. **An approval watcher**, if your desktop raises a permission card for every browser action —
- [`setup/auto-approve-macos.md`](setup/auto-approve-macos.md) ·
- [`setup/auto-approve-windows.md`](setup/auto-approve-windows.md).
- **Carts and payment stay manual on purpose** — the watcher never touches them.
- ## The workflow
- | phase | produces | gate |
- |---|---|---|
- | 1 Concept | hard vs soft constraints, agreed | every question whose two answers give a different board has been asked |
- | 2 Schematic + sourcing | schematic, priced BOM, staged carts | netlist assertions pass; every price VERIFIED or labelled ESTIMATE |
- | 3 Layout + routing | placed, routed, poured board | placement is *routable*, not merely legal; DRC clean; adversarial review clear |
- | 4 Fabrication + purchase | verified Gerber, order at the pre-payment page | the package is verified independently of the tool that made it |
- **The agent never places an order and never pays.** It drives to the pre-payment page and hands you the click.
- ## What is in here
- ```
- skills/pcb/SKILL.md the skill itself
- skills/pcb/references/ loaded on demand: workflow, review protocol, manufacturing,
- sourcing, EDA-MCP traps, mechanical/3D, bring-up
- scripts/placement/ courtyards from real pads, via lanes, module-body clearance
- scripts/routing/ Specctra DSN/SES autoroute chain, four-state watchdog, rate floor
- scripts/verify/ Gerber parsing, clearance sweeps, drill census, netlist assertions,
- 3D interference — deliberately independent of the EDA
- scripts/notify/ a progress relay, so a long run is never silent
- setup/ getting the environment ready
- docs/case-study.md one board, the defects the process caught, and the honest cost
- ```
- ## Four rules that did the work
- - **A green board is not a correct board.** Every phase ends with a one-pass, read-only adversarial review
- that re-derives the numbers instead of reading them — and its termination criterion is written *before*
- it starts, or it loops.
- - **Measured, not inferred.** "This probably is not supported" is not a finding. If a claim decides whether
- work continues, prove it, and say which numbers were measured and which computed.
- - **Verify the tool before the result.** Three checkers on the reference project silently measured the wrong
- thing. Calibrate every geometric transform against a known asymmetric object.
- - **A wait condition must answer:** if this crashed right now, would my filter emit a line? One run on the
- reference project sat silent for 10 h 53 m because the answer was no.
- ## Licence
- MIT — see [`LICENSE`](LICENSE).
- ## Star history
- <a href="https://star-history.com/#daishuge/pcb-skill&Date">
- <picture>
- <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=daishuge/pcb-skill&type=Date&theme=dark" />
- <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=daishuge/pcb-skill&type=Date" />
- <img alt="Star history chart for daishuge/pcb-skill" src="https://api.star-history.com/svg?repos=daishuge/pcb-skill&type=Date" />
- </picture>
- </a>
- ## 友情链接
- - [linux.do](https://linux.do)
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.