Skip to content
Back to search

cupraxis

SkillWorks with Claude CodeGitHub

Cupraxis — Claude Code skill + source-tagged knowledge base for PCB design: floorplan, power, RF, EMC, components, DFM, KiCad 10 toolchain and vendor-agnostic fabrication (JLCPCB, PCBWay, Aisler, Eurocircuits…)

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/auvorix--cupraxis/badge.svg)](/listings/auvorix--cupraxis)

HTML

<a href="/listings/auvorix--cupraxis"><img src="/api/listings/auvorix--cupraxis/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.

**Claude Code (recommended)**

git clone https://github.com/auvorix/cupraxis.git
# user-wide
cp -r cupraxis/skill/cupraxis ~/.claude/skills/
# or project-only
cp -r cupraxis/skill/cupraxis <your-project>/.claude/skills/

The skill triggers on PCB tasks such as "plan the floorplan of my board", "review this layout", "generate JLC fab files" or "which fab should I use?". You can also call it explicitly with `/cupraxis`.

**Requirements for the scripts (optional):** - KiCad 10. Run the `pcbnew` scripts with KiCad's own `python.exe` (`%LOCALAPPDATA%\Programs\KiCad\10.0\bin\python.exe` on Windows). - Python 3.10+. - For `jlc_query.py`: the JLCPCB parts database downloaded by [KiCAD-MCP-Server](https://github.com/mixelpixx/KiCAD-MCP-Server), or set `JLC_DB`.

python pcb_audit.py board.kicad_pcb --json audit.json        # read-only gate
python jlc_query.py "mfr_part like 'TPS63020%'"               # parts lookup

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 · 119 lines
  1. <div align="center">
  2. # Cupraxis
  3. **A Claude Code skill and an open, source-tagged knowledge base for designing printed circuit boards, from requirements to the factory.**
  4. KiCad 10 · kicad-cli · Freerouting · KiCad-MCP · JLCPCB · PCBWay · Aisler · Eurocircuits · OSH Park
  5. [![License: MIT](https://img.shields.io/badge/code-MIT-blue.svg)](LICENSE)
  6. [![License: CC BY 4.0](https://img.shields.io/badge/docs-CC%20BY%204.0-lightgrey.svg)](LICENSE-docs)
  7. [![KiCad 10](https://img.shields.io/badge/KiCad-10.0-314cb0.svg)](https://www.kicad.org/)
  8. [![Claude Code skill](https://img.shields.io/badge/Claude%20Code-skill-d97757.svg)](https://docs.claude.com/en/docs/claude-code/skills)
  9. [Português](#português) · [What it does](#what-it-does) · [Install](#install) · [Repository layout](#repository-layout) · [Evaluation](#evaluation) · [Sources and licensing](#sources-and-licensing)
  10. </div>
  11. ---
  12. ## What it does
  13. `cupraxis` turns Claude into a hardware design reviewer and planner that thinks about what actually breaks boards in production: edge mechanics, assembly rules, RF, power integrity, EMC and sourcing. A DRC catches only part of that.
  14. - **Floorplan by zones:** power, digital, analog, RF/antenna, connectors and human interface, with a placement order and proximity rules for every component type.
  15. - **Power:** buck, boost and buck-boost hot loops, LDO vs LC filtering, ferrite resonance, LiPo/USB-C power paths, current-based trace and via sizing.
  16. - **RF:** antenna keepouts, CPWG vs microstrip, matching networks, via fences at ≤ λ/20, coexistence, SMA/u.FL.
  17. - **Grounding, SI and EMC:** return paths, stackups, USB 90 Ω pairs, crystals, ESD/TVS placement, and why the 20H and 3W rules are contested.
  18. - **Component selection:** MLCC DC-bias derating, inductors (Isat vs Irms), crystals, connectors, lifecycle and MSL.
  19. - **Board shape and DFM:** outlines from official DXF/STEP, mounting holes, panelization, silkscreen minimums, enclosure co-design.
  20. - **Vendor-agnostic manufacturing:** a common-minimum rule set, per-vendor BOM/CPL formats, DRU files, and EU import rules (VAT, IOSS, the 2026 per-line duty).
  21. - **Review checklists:** schematic review by part class, measurable EMC/PDN layout thresholds, return-via and connector ground-pin rules backed by primary sources, battery sleep budget, and EN 55032 pre-compliance.
  22. - **Toolchain know-how, tested on KiCad 10.0.8:** `kicad-cli` recipes and their traps, `.kicad_dru` rules, the `pcbnew` API, Freerouting, and the KiCad-MCP limitations.
  23. - **Scripts:** a read-only board audit for edge connectors, the 2.5 mm assembly rule, MLCC flex risk, silk minimums and thin power traces. Also included: rip-up, spread, GND stitching fixes, a JLC/LCSC parts query, and a BOM/CPL converter.
  24. Every technical claim in the knowledge base carries a source URL and a **FATO** (verified in the source) or **INFERÊNCIA** (inference / common practice) tag.
  25. ## Install
  26. **Claude Code (recommended)**
  27. ```bash
  28. git clone https://github.com/auvorix/cupraxis.git
  29. # user-wide
  30. cp -r cupraxis/skill/cupraxis ~/.claude/skills/
  31. # or project-only
  32. cp -r cupraxis/skill/cupraxis <your-project>/.claude/skills/
  33. ```
  34. The skill triggers on PCB tasks such as "plan the floorplan of my board", "review this layout", "generate JLC fab files" or "which fab should I use?". You can also call it explicitly with `/cupraxis`.
  35. **Requirements for the scripts (optional):**
  36. - KiCad 10. Run the `pcbnew` scripts with KiCad's own `python.exe` (`%LOCALAPPDATA%\Programs\KiCad\10.0\bin\python.exe` on Windows).
  37. - Python 3.10+.
  38. - For `jlc_query.py`: the JLCPCB parts database downloaded by [KiCAD-MCP-Server](https://github.com/mixelpixx/KiCAD-MCP-Server), or set `JLC_DB`.
  39. ```bash
  40. python pcb_audit.py board.kicad_pcb --json audit.json # read-only gate
  41. python jlc_query.py "mfr_part like 'TPS63020%'" # parts lookup
  42. ```
  43. ## Repository layout
  44. ```
  45. skill/cupraxis/ ← the installable skill
  46. SKILL.md workflow with gates, zoning map, proximity table, key numbers
  47. references/ 00–13 topic files + house rules + host templates (RPi HAT, Flipper)
  48. scripts/ pcb_audit, ripup, spread, gnd_fix, island_fix, jlc_query, kicad_to_jlc
  49. evals/ test cases (claude plugin eval format)
  50. research/ the full research corpus in Markdown (source of the references)
  51. boas-praticas/ 01 floorplan · 02 power · 03 RF · 04 GND/SI/EMC · 05 components
  52. 06 shape/DFM · 07 bibliography · 08 KiCad · 09 fab/MCP/CAD · 10 vendors
  53. 11 related skills · 12 return vias & GND pins · 13 review checklists
  54. hosts/ host templates (tagged [FLIPPER] where Flipper-specific)
  55. docs/
  56. pdf-catalog.md every vendor PDF used, with its official download link
  57. evaluation.md benchmark of the skill vs no skill
  58. ```
  59. Placeholders used in the files: `<REFERENCIAS>` is this repo's `research/` folder. `%USERPROFILE%` is your home folder. `<BRANDING>` and `<DEVSHARED>` are the author's local folders and are not needed to use the skill.
  60. ## Evaluation
  61. The skill was built with Anthropic's skill-creator loop. Each test prompt ran **with** and **without** the skill, and an independent grader checked every assertion against the outputs. See [docs/evaluation.md](docs/evaluation.md).
  62. | Iteration | Assertions | With skill | Without skill |
  63. |---|---|---|---|
  64. | 1 | 47 | 100 % | 96 % |
  65. | 2 (harder, accuracy-focused) | 64 | 98 % | 81 % |
  66. | 3 (unseen motor-driver case + fixes) | 25 | 96 % | 84–87 % |
  67. The baseline was competent but made factual errors that the skill avoided. Examples: wrong JLC minimums, the wrong Raspberry Pi HAT outline for the header type, a wrong Eurocircuits class, and missing assembly constraints (2.5 mm edge, 70×70 mm double-sided minimum, the HAT+ STANDBY state).
  68. ## Sources and licensing
  69. - **Code** (`skill/cupraxis/scripts`, etc.): [MIT](LICENSE).
  70. - **Documentation and research text**: [CC BY 4.0](LICENSE-docs).
  71. - **Third-party PDFs** (TI, ADI, ST, NXP, Espressif, u-blox, Murata, Würth, Vishay, JST, Raspberry Pi…) are **not redistributed**. [docs/pdf-catalog.md](docs/pdf-catalog.md) lists each one with its official link.
  72. - Flipper Zero mechanical files are GPL-3.0 at [flipperdevices/flipperzero-3d-models](https://github.com/flipperdevices/flipperzero-3d-models). Flipper One docs have no declared license, so they are linked only.
  73. - Vendor capabilities, prices and tax rules change. Every number carries its consultation date; check the vendor page before ordering.
  74. ---
  75. ## Português
  76. **Cupraxis** é uma skill do Claude Code e uma base de conhecimento aberta, com fontes etiquetadas (FATO / INFERÊNCIA), para projetar placas do requisito à fábrica.
  77. O que cobre:
  78. - floorplan por zonas;
  79. - energia e fontes chaveadas;
  80. - RF e antenas;
  81. - aterramento, integridade de sinal e EMC;
  82. - escolha de componentes;
  83. - formato, fabricabilidade e estética;
  84. - fabricação com qualquer fornecedor (JLCPCB, PCBWay, Aisler, Eurocircuits…);
  85. - a cadeia de ferramentas do KiCad 10, testada na prática.
  86. Toda a pesquisa está em português em [`research/boas-praticas/`](research/boas-praticas/). Para instalar, copie `skill/cupraxis` para `~/.claude/skills/`.
  87. Maintained by [AUVORIX](https://github.com/auvorix).

Ratings and comments

Sign in to rate this skill.

Sign in

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