hashgraph-online/awesome-codex-plugins / plugins/aklofas/kicad-happy/skills/bom
bom
VerifiedBOM (Bill of Materials) management for electronics projects — the workflow skill that coordinates DigiKey, Mouser, LCSC, element14, JLCPCB, PCBWay, and KiCad skills around a unified BOM lifecycle. Create, update, and maintain BOMs with part numbers, costs, quantities stored as KiCad symbol properties. ALWAYS trigger this skill for any task involving component sourcing, pricing, ordering, distributor searches, BOM export, or fabrication preparation — even if the user names a specific distributor or fab house (e.g. "search DigiKey for...", "generate JLCPCB BOM", "order from Mouser"). This skill analyzes the schematic for sourcing gaps, recommends which distributor/fab skills to call for each gap, and writes results back as symbol properties — the agent (or user) performs the actual searches via the called skills. Also trigger on phrases like "what parts do I need", "order components", "how much will this cost", "export for JLCPCB", "find parts for this board", "compare pricing", or "check stock".
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 22.3 KB |
| references/kicad-fields.md | markdown | 3.2 KB |
| references/ordering-and-fabrication.md | markdown | 5.1 KB |
| references/part-number-conventions.md | markdown | 19.2 KB |
| scripts/_core_path.py | script | 697 B |
| scripts/bom_fields.py | script | 5.4 KB |
| scripts/bom_manager.py | script | 60.5 KB |
| scripts/edit_properties.py | script | 18.2 KB |
| scripts/kicad_sexp.py | script | 10.6 KB |
| scripts/sync_datasheet_urls.py | script | 16.2 KB |
| scripts/translate_bom_pnp.py | script | 28.8 KB |
references/kicad-fields.md
View on GitHub# KiCad Symbol Properties Reference
## Standard Fields
| Field | Description | Example |
|-------|-------------|---------|
| `Reference` | Designator (auto) | `C1`, `U3`, `R5` |
| `Value` | Component value | `100nF`, `ESP32-S3-WROOM-1` |
| `Footprint` | Library:footprint | `Capacitor_SMD:C_0402_1005Metric` |
| `Datasheet` | URL to datasheet | `https://...` |
| `Description` | Part description | `100nF 16V X7R 0402 MLCC` |
## Custom BOM Fields
| Field | Purpose | When | Example |
|-------|---------|------|---------|
| `MPN` | Manufacturer Part Number | Always | `GRM155R71C104KA88D` |
| `Manufacturer` | Part manufacturer | Always | `Murata` |
| `DigiKey` | DigiKey PN — primary prototype source | Prototype | `490-10698-1-ND` |
| `Mouser` | Mouser PN — secondary prototype source | Prototype | `81-GRM155R71C104KA8D` |
| `LCSC` | LCSC PN — production assembly source | Production | `C14663` |
| `AltMPN` | Alternate/second-source MPN | Optional | `CL05B104KO5NNNC` |
| `BOM Comments` | Freeform per-component ordering/assembly notes (flows into CSV Notes column) | Optional | `Proto only — DNP in production` |
## Field Name Aliases
Projects use inconsistent field names. The analyzer recognizes all common variants:
| Canonical | Also Recognized As |
|---|---|
| `MPN` | `Manufacturer Part Number`, `Manufacturer_Part_Number`, `Manufacturer Part #`, `PartNumber`, `Part Number`, `Mfr_No`, `ManufacturerPartNumber` |
| `Manufacturer` | `Manufacturer_Name`, `Mfr`, `MFR` |
| `DigiKey` | `Digi-Key Part Number`, `Digi-Key_PN`, `DigiKey Part`, `DigiKey_Part_Number`, `DK` |
| `Mouser` | `Mouser Part Number`, `Mouser Part`, `Mouser_PN`, `Mouser PN` |
| `LCSC` | `LCSC Part #`, `LCSC Part Number`, `LCSCStockCode`, `JLCPCB`, `JLCPCB Part`, `JLC` |
| `element14` | `Newark`, `Newark Part Number`, `Newark_PN`, `Farnell`, `Farnell_PN`, `element14_PN` |
| `BOM Comments` | `BOM_Comments`, `BOM Comment`, `BOM_Comment`, `BOM Notes`, `BOM_Notes`, `BOM Note`, `Ordering Notes`, `Assembly Notes`, `Notes`, `Remarks`, `Comment` |
When writing new fields, use the canonical names for consistency. When a project already has a convention (e.g., `Digi-Key_PN`), respect it.
## S-expression Format
Custom fields in `.kicad_sch` files:
```
(property "MPN" "GRM155R71C104KA88D"
(at 0 0 0)
(effects (font (size 1.27 1.27)) (hide yes))
)
```
## Adding/Editing Properties in KiCad
- **Single symbol**: Double-click or E > "+" to add field
- **Bulk editing**: Tools > Edit Symbol Fields (spreadsheet view, supports CSV export/import)
- **Field Name Templates** (KiCad 9+): Schematic Setup > Field Name Templates — pre-define MPN, Manufacturer, etc.
## Part Number Patterns
- **MPN is the universal key** — cross-references across all distributors
- **DigiKey PNs** end in `-ND` (e.g., `311-10.0KCRCT-ND`)
- **Mouser PNs** have numeric prefixes (e.g., `81-GRM155R71C104KA8D`)
- **LCSC PNs** are `Cxxxxx` (e.g., `C14663`)
- **Newark/Farnell PNs** are alphanumeric SKUs (e.g., `94AK6874`)
- Any identifier is useful — even a single distributor PN can be used to find the MPN and other PNs
- Parts with no identifiers need manual enrichment before datasheet sync or ordering
For detailed analysis of part number conventions across 56+ real-world projects, see `part-number-conventions.md`.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation). | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply. | Stars: 197k | Updated | Claude CodeCodex | Verified | Install |
| frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults. | Stars: 197k | Updated | Claude CodeCodex | Verified | Install |
| mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK). | Stars: 197k | Updated | Claude CodeCodex | Verified | Install |