Skip to content
Back to search

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.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/daishuge--pcb-skill/badge.svg)](/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

i

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)

  1. # PCB skill
  2. An agent skill for taking a hardware idea all the way to **a board you can order, solder and bring up** —
  3. concept, schematic, sourcing, layout, routing, verification, and a purchase staged to the pre-payment page.
  4. It runs inside **Claude Code (desktop)** or **Codex (desktop)**, drives **EasyEDA Pro over MCP**, and does
  5. its shopping in a browser you are already logged in to.
  6. > This is not a tutorial about PCB theory. It is the set of gates that catch the things theory does not:
  7. > a socket rotated so the display can never be plugged in, a capacitor under a module body, a keep-out that
  8. > exists only on a drawing layer, a checker quietly measuring the previous release. Every rule here was paid
  9. > for on a real board — see [`docs/case-study.md`](docs/case-study.md).
  10. ## The three principles
  11. | | |
  12. |---|---|
  13. | **性价比** cost-effectiveness | every part priced from a live page or labelled an estimate; the BOM netted against stock you already own |
  14. | **好装配** assemblable by hand | you are the assembler — no bottom-terminated packages, every pad reachable, a soldering order that does not trap a joint |
  15. | **免费 PCB** a free prototype | design inside the free-prototype envelope from the first sketch, not at the end |
  16. ## Install
  17. `SKILL.md` loads `references/`, `scripts/` and `setup/` as its own siblings, so all three have to land
  18. in the skill directory. This repo keeps `scripts/` and `setup/` at the top level so they stay browsable
  19. here — copying only `skills/pcb/` gives you a skill whose checkers and setup guides are simply absent.
  20. ```bash
  21. git clone https://github.com/daishuge/pcb-skill.git
  22. cd pcb-skill
  23. DEST=~/.claude/skills/pcb # Codex: DEST=~/.codex/skills/pcb
  24. mkdir -p "$DEST" && cp -R skills/pcb/. scripts setup "$DEST"/
  25. # verify — a missing directory here fails later, in the middle of a design
  26. ls "$DEST"/SKILL.md "$DEST"/references "$DEST"/scripts "$DEST"/setup >/dev/null && echo "pcb installed"
  27. ```
  28. Then work through [`setup/README.md`](setup/README.md) — the skill checks these before it starts:
  29. 1. **EasyEDA Pro + the MCP bridge** — [`setup/easyeda-mcp.md`](setup/easyeda-mcp.md)
  30. 2. **A browser with the agent extension, logged in** to your PCB house and your parts suppliers —
  31. [`setup/browser-logins.md`](setup/browser-logins.md)
  32. 3. **An approval watcher**, if your desktop raises a permission card for every browser action —
  33. [`setup/auto-approve-macos.md`](setup/auto-approve-macos.md) ·
  34. [`setup/auto-approve-windows.md`](setup/auto-approve-windows.md).
  35. **Carts and payment stay manual on purpose** — the watcher never touches them.
  36. ## The workflow
  37. | phase | produces | gate |
  38. |---|---|---|
  39. | 1 Concept | hard vs soft constraints, agreed | every question whose two answers give a different board has been asked |
  40. | 2 Schematic + sourcing | schematic, priced BOM, staged carts | netlist assertions pass; every price VERIFIED or labelled ESTIMATE |
  41. | 3 Layout + routing | placed, routed, poured board | placement is *routable*, not merely legal; DRC clean; adversarial review clear |
  42. | 4 Fabrication + purchase | verified Gerber, order at the pre-payment page | the package is verified independently of the tool that made it |
  43. **The agent never places an order and never pays.** It drives to the pre-payment page and hands you the click.
  44. ## What is in here
  45. ```
  46. skills/pcb/SKILL.md the skill itself
  47. skills/pcb/references/ loaded on demand: workflow, review protocol, manufacturing,
  48. sourcing, EDA-MCP traps, mechanical/3D, bring-up
  49. scripts/placement/ courtyards from real pads, via lanes, module-body clearance
  50. scripts/routing/ Specctra DSN/SES autoroute chain, four-state watchdog, rate floor
  51. scripts/verify/ Gerber parsing, clearance sweeps, drill census, netlist assertions,
  52. 3D interference — deliberately independent of the EDA
  53. scripts/notify/ a progress relay, so a long run is never silent
  54. setup/ getting the environment ready
  55. docs/case-study.md one board, the defects the process caught, and the honest cost
  56. ```
  57. ## Four rules that did the work
  58. - **A green board is not a correct board.** Every phase ends with a one-pass, read-only adversarial review
  59. that re-derives the numbers instead of reading them — and its termination criterion is written *before*
  60. it starts, or it loops.
  61. - **Measured, not inferred.** "This probably is not supported" is not a finding. If a claim decides whether
  62. work continues, prove it, and say which numbers were measured and which computed.
  63. - **Verify the tool before the result.** Three checkers on the reference project silently measured the wrong
  64. thing. Calibrate every geometric transform against a known asymmetric object.
  65. - **A wait condition must answer:** if this crashed right now, would my filter emit a line? One run on the
  66. reference project sat silent for 10 h 53 m because the answer was no.
  67. ## Licence
  68. MIT — see [`LICENSE`](LICENSE).
  69. ## Star history
  70. <a href="https://star-history.com/#daishuge/pcb-skill&Date">
  71. <picture>
  72. <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=daishuge/pcb-skill&type=Date&theme=dark" />
  73. <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=daishuge/pcb-skill&type=Date" />
  74. <img alt="Star history chart for daishuge/pcb-skill" src="https://api.star-history.com/svg?repos=daishuge/pcb-skill&type=Date" />
  75. </picture>
  76. </a>
  77. ## 友情链接
  78. - [linux.do](https://linux.do)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.