agentleFS
daishugedaishuge/pcb-skill/skills/pcb/SKILL.md

pcb

Skill136 starsChanged 2 months agoMITView on GitHub

Design a manufacturable PCB end to end — concept, schematic, layout, routing, verification, and a staged purchase — driven from Claude Code or Codex on the desktop, with EasyEDA Pro over MCP and JLC/LCSC/Taobao in a logged-in browser. Optimises for cost-effectiveness, hand-assembly, and a free prototype board.

2 other projects use a version of this, 1 of them edited.

Adopted by

Most recently taken up by

  • Other versions2 projects use a version of this.

    Word for word · 0

    None found.

    Edited · 1

    1. 1999AZZAR/pcb-skill★ 155% same

    Wrote their own version · 1

    1. earthtojake/text-to-cad★ 26ksame name

    How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.

The file

We split this skill into the rules it gives an agent

5 rules. About 0 are common, 3 are distinctive, and 2 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈3

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 2

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    性价比 — cost-effectiveness: Every part is chosen on measured price and real availability, netted against stock the user already owns.

    line 16
  2. Distinctive:

    Do not begin design work until these are true.

    line 27
  3. Very specific:

    An approval watcher: if the platform pops permission cards for every browser action, or the agent blocks on a card it cannot press itself.

    line 33
  4. Very specific:

    Read references/01-workflow.md for the full version.

    line 41
  5. Distinctive:

    A green board is not a correct board: Every phase ends with a one-pass, read-only, adversarial review by a fresh reviewer that re-derives …

    line 56

≈ “Common” is an estimate: at least 1 in 5 of the 364,980 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

PCB

Take a hardware idea to a board a human can actually order, solder and bring up.

This skill is written from a real project that went from a blank page to a released 4-layer board. Most of what is here is not PCB theory — it is the specific set of failures that theory does not catch, and the gates that catch them.

The three principles this skill optimises for

  1. 性价比 — cost-effectiveness. Every part is chosen on measured price and real availability, netted against stock the user already owns. A price nobody has read off a live page is an ESTIMATE and must be labelled as one.
  2. 好装配 — assemblable by hand. The user solders this. No QFN/DFN/exposed-pad-only packages unless the user says otherwise. Every pad reachable with an iron, in an order that does not trap a joint behind a tall part.
  3. 免费 PCB — the board should cost nothing. JLC's free-prototype coupon has hard geometric and process limits. Design inside them from the first sketch, not at the end.

Before you start — the environment must be ready

Do not begin design work until these are true. Check, do not assume.

  • EasyEDA Pro running, with the MCP bridge installed and answering (server_info). See setup/easyeda-mcp.md.
  • A browser with the agent extension, logged in to the sites the project needs: Taobao, JD, JLC/LCSC. See setup/browser-logins.md.
  • An approval watcher if the platform pops permission cards for every browser action, or the agent blocks on a card it cannot press itself. See setup/auto-approve-*.md. Carts and payment stay manual — the watcher is deliberately bypassed there.
  • A notification channel for long runs (scripts/notify/), so silence is never ambiguous.

The workflow — four phases, each with a gate

Read references/01-workflow.md for the full version. In outline:

phaseproducesgate before moving on
1 Conceptwhat it does, for whom, the hard vs soft constraintsthe user has answered every question whose two answers give different boards
2 Schematic + sourcingfull schematic, priced BOM, staged cartsnetlist assertions pass; every price VERIFIED or labelled ESTIMATE
3 Layout + routingplaced, routed, poured boardplacement is routable, not merely legal; DRC 0/0; adversarial review clear
4 Fabrication + purchaseverified Gerber, order at the pre-payment pagethe package is verified independently of the EDA that produced it

Never place an order or pay. Drive to the pre-payment page and stop.

The rules that actually caught the bugs

These are load-bearing. references/02-review.md explains each with the failure it caught.

  • A green board is not a correct board. Every phase ends with a one-pass, read-only, adversarial review by a fresh reviewer that re-derives the numbers instead of reading them. Write its termination criterion before it starts, or it will loop.
  • Measured, not inferred. "X probably does not support Y" is not a finding. If a claim decides whether work continues, prove it. Say which numbers were measured and which were computed.
  • A wait condition must answer: if this crashed right now, would my filter emit a line? Watchdogs cover four terminal states — output present, crash signature, process gone, wall-clock timeout — plus a progress-rate floor.
  • Verify the tool before trusting the result. Three separate checkers on this project silently measured the wrong thing (a cached 3D model, a bounding box instead of a pad, a merged copper label). Calibrate every geometric transform against a known asymmetric object.
  • The last honest step is the user's. Logins, CAPTCHAs, and payment are theirs. Prepare everything else so their part is two minutes.

References — load what the current phase needs

filewhen
references/01-workflow.mdalways, at the start
references/02-review.mdbefore every review, and when writing any checker
references/03-jlc-manufacturing.mdbefore fixing the board outline, stack-up or rules
references/04-sourcing.mdchoosing parts, pricing, netting against stock, staging carts
references/05-easyeda-mcp.mdbefore the first write to EasyEDA — it is a trap list
references/06-mechanical.mdbefore declaring a board assemblable; 3D, connectors, folds
references/07-bringup.mdflashing and first power-up, especially with no USB-serial adapter

Scripts

scripts/ holds the checkers this workflow depends on. They are deliberately independent of the EDA: they parse exported documents and Gerbers, so they can contradict the tool that produced them. Each directory has its own README.

  • scripts/placement/ — courtyards from real pads, via-lane widths, module-body clearance
  • scripts/routing/ — the DSN/SES autoroute chain with a four-state watchdog and a rate floor
  • scripts/verify/ — netlist assertions, Gerber parsing, drill census, 3D interference
  • scripts/notify/ — a progress relay so a long run is never silent

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.