main
Download ZIP Propose a change
Name Last commit message Last updated
docs Publish 0.2.0 · Ray 11d ago
scripts Publish 0.2.0 · Ray 11d ago
skills Publish 0.2.2 · Ray 11d ago
install.sh Publish 0.2.0 · Ray 11d ago
package.json Publish 0.2.2 · Ray 11d ago
page.json Publish 0.2.2 · Ray 11d ago
README.md Publish 0.2.0 · Ray 11d ago
uninstall.sh Publish 0.2.0 · Ray 11d ago

Alternate Part

Which part can replace this one on my board, and can I buy it today?

Most parts come in many variants, only a few are in stock at any moment, and which few depends on the distributor. A same-footprint swap is usually fine, but a cautious agent refuses it "because of a pin function you don't use", and a careless one approves a part that swaps two pins the board does use. This skill asks the right question: does the replacement give every pin function this design uses, on the same pins, and is it in stock?

How it works

  1. It reads the chip's pads from your board. A pin is used when its net reaches another part.
  2. It sends those pins (and their net names) to Component Ocean's POST /api/alternates.
  3. Component Ocean answers in one of four tiers, and says which and how sure it is:
tier parts checked against confidence
1 STM32 MCUs ST's own open pin data, every pin and function high
2 any part with an Adom component page (about 98,000) the pages' datasheet-verified pin tables and footprints medium-high
3 passives, MOSFETs, diodes, transistors, LDOs, 74-series logic catalog parameters; pin-order traps flagged medium, lower where the pin order is unchecked
4 everything else nothing verified: the skill walks the AI through checking candidates from their datasheets stated with the answer
  1. Candidates come back ranked: in stock now first, then no downgrade, then the closest spec. Every stock number says where it came from: live (at most an hour old), cached (older, with its age) or the JLCPCB catalog snapshot (with its date).
python3 ~/.claude/skills/alternate-part/scripts/alternates.py board.kicad_pcb --ref U1
python3 ~/.claude/skills/alternate-part/scripts/alternates.py --mpn LM358DR

Example, the STM32F411RET6 on an Adom MCU board: 29 of its 64 pins are used; the parts that fit come back with the pins that block each rejected one. An LM358DR gets tier 2: TL082CDT, LM258DT and MC33178DR2G among its same-pinout SOIC-8 dual op-amps.

A good candidate with no Adom page can be requested (POST /api/part-request); once built, it has tier 2 data for everyone.

Install

adom-wiki pkg install adom/alternate-part, then ask Claude "this chip is out of stock, what can replace it on my board?"