# Send KiCad PCB to your agent
Use the source page and any available docs to guide the install because the item currently does not return a direct package file.
## Fast path
- Open the source page via Open source listing.
- If you can obtain the package, extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the source page and extracted files.
## Suggested prompts
### New install

```text
I tried to install a skill package from Yavira, but the item currently does not return a direct package file. Inspect the source page and any extracted docs, then tell me what you can confirm and any manual steps still required.
```
### Upgrade existing

```text
I tried to upgrade a skill package from Yavira, but the item currently does not return a direct package file. Compare the source page and any extracted docs with my current installation, then summarize what changed and what manual follow-up I still need.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "kicad-pcb",
    "name": "KiCad PCB",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/G0HEAD/kicad-pcb",
    "canonicalUrl": "https://clawhub.ai/G0HEAD/kicad-pcb",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/kicad-pcb",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=kicad-pcb",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "scripts/kicad_pcb.py",
      "skill.json"
    ],
    "downloadMode": "manual_only",
    "sourceHealth": {
      "source": "tencent",
      "slug": "kicad-pcb",
      "status": "source_issue",
      "reason": "not_found",
      "recommendedAction": "review_source",
      "checkedAt": "2026-05-04T18:14:39.732Z",
      "expiresAt": "2026-05-05T18:14:39.732Z",
      "httpStatus": 404,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=kicad-pcb",
      "contentType": "text/plain",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=kicad-pcb",
        "contentDisposition": null,
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "kicad-pcb"
      },
      "scope": "item",
      "summary": "Known item issue.",
      "detail": "This item's current download entry is known to bounce back to a listing or homepage instead of returning a package file.",
      "primaryActionLabel": "Open source listing",
      "primaryActionHref": "https://clawhub.ai/G0HEAD/kicad-pcb"
    },
    "validation": {
      "installChecklist": [
        "Open the source listing and confirm there is a real package or setup artifact available.",
        "Review SKILL.md before asking your agent to continue.",
        "Treat this source as manual setup until the upstream download flow is fixed."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/kicad-pcb",
    "downloadUrl": "https://openagent3.xyz/downloads/kicad-pcb",
    "agentUrl": "https://openagent3.xyz/skills/kicad-pcb/agent",
    "manifestUrl": "https://openagent3.xyz/skills/kicad-pcb/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/kicad-pcb/agent.md"
  }
}
```
## Documentation

### 🔧 KiCad PCB Automation

Design → Prototype → Manufacture

Automate PCB design workflows using KiCad. From natural language circuit descriptions to manufacturing-ready Gerber files.

### What This Skill Does

Design — Create schematics from circuit descriptions
Layout — Design PCB layouts with component placement
Verify — Run DRC checks, generate previews for review
Export — Generate manufacturing files (Gerbers, drill files, BOM)
Order — Prepare and place orders on PCBWay

### KiCad Installation

# Ubuntu/Debian
sudo add-apt-repository ppa:kicad/kicad-8.0-releases
sudo apt update
sudo apt install kicad

# Verify CLI
kicad-cli --version

### Python Dependencies

pip install pillow cairosvg

### Quick Start

# 1. Create a new project
python3 scripts/kicad_pcb.py new "LED Blinker" --description "555 timer LED blinker circuit"

# 2. Add components to schematic
python3 scripts/kicad_pcb.py add-component NE555 U1
python3 scripts/kicad_pcb.py add-component LED D1
python3 scripts/kicad_pcb.py add-component "R 1K" R1 R2

# 3. Generate schematic preview (for review)
python3 scripts/kicad_pcb.py preview-schematic

# 4. Run design rule check
python3 scripts/kicad_pcb.py drc

# 5. Export manufacturing files
python3 scripts/kicad_pcb.py export-gerbers

# 6. Prepare PCBWay order
python3 scripts/kicad_pcb.py pcbway-quote --quantity 5

### Project Management

CommandDescriptionnew <name>Create new KiCad projectopen <path>Open existing projectinfoShow current project infolist-projectsList recent projects

### Schematic Design

CommandDescriptionadd-component <type> <ref>Add component to schematicconnect <ref1.pin> <ref2.pin>Wire components togetheradd-net <name> <refs...>Create named netpreview-schematicGenerate schematic imageercRun electrical rules check

### PCB Layout

CommandDescriptionimport-netlistImport schematic to PCBauto-placeAuto-place componentsauto-routeAuto-route tracesset-board-size <W>x<H>Set board dimensions (mm)preview-pcbGenerate PCB preview imagesdrcRun design rules check

### Manufacturing Export

CommandDescriptionexport-gerbersExport Gerber filesexport-drillExport drill filesexport-bomExport bill of materialsexport-posExport pick-and-place fileexport-3dExport 3D model (STEP/GLB)package-for-fabCreate ZIP with all files

### PCBWay Integration

CommandDescriptionpcbway-quoteGet instant quotepcbway-uploadUpload Gerbers to PCBWaypcbway-cartAdd to cart (requires auth)

### Step 1: Describe Your Circuit

Tell me what you want to build:

"I need a simple 555 timer circuit that blinks an LED at about 1Hz.
Should run on 9V battery, through-hole components for easy soldering."

### Step 2: I'll Generate the Design

# Create project
kicad_pcb.py new "LED_Blinker_555"

# Add components based on description
kicad_pcb.py from-description "555 timer LED blinker, 1Hz, 9V battery"

### Step 3: Review & Confirm

I'll show you:

Schematic preview image
Component list (BOM)
Calculated values (resistors for timing, etc.)

You confirm or request changes.

### Step 4: PCB Layout

# Import to PCB
kicad_pcb.py import-netlist

# Auto-layout (or manual guidance)
kicad_pcb.py auto-place --strategy compact
kicad_pcb.py set-board-size 50x30

# Preview
kicad_pcb.py preview-pcb --layers F.Cu,B.Cu,F.Silkscreen

### Step 5: Manufacturing

# Run final checks
kicad_pcb.py drc --strict

# Export everything
kicad_pcb.py package-for-fab --output LED_Blinker_fab.zip

# Get quote
kicad_pcb.py pcbway-quote --quantity 10 --layers 2 --thickness 1.6

### templates/555_astable.kicad_sch

Classic 555 timer in astable mode. Parameters:

R1, R2: Timing resistors
C1: Timing capacitor
Freq ≈ 1.44 / ((R1 + 2*R2) * C1)

### templates/arduino_shield.kicad_pcb

Arduino Uno shield template with:

Header footprints
Mounting holes
Power rails

### templates/usb_c_power.kicad_sch

USB-C power delivery (5V):

USB-C connector
CC resistors
ESD protection

### Configuration

Create ~/.kicad-pcb/config.json:

{
  "default_fab": "pcbway",
  "pcbway": {
    "email": "your@email.com",
    "default_options": {
      "layers": 2,
      "thickness": 1.6,
      "color": "green",
      "surface_finish": "hasl"
    }
  },
  "kicad_path": "/usr/bin/kicad-cli",
  "projects_dir": "~/kicad-projects",
  "auto_backup": true
}

### Design Review Protocol

Before ordering, I'll always:

Show schematic — Visual confirmation of circuit
Show PCB renders — Top, bottom, 3D view
List BOM — All components with values
Report DRC — Any warnings or errors
Show quote — Cost breakdown before ordering

I will NOT auto-order without explicit confirmation.

### PCBWay Order Flow (Current)

Export Gerbers + drill files
Create ZIP package
Manual step: You upload to pcbway.com
Future: Automated upload + cart placement

### Cost Reference

PCBWay typical pricing (2-layer, 100x100mm, qty 5):

Standard (5-7 days): ~$5
Express (3-4 days): ~$15
Shipping: ~$15-30 DHL

### Safety Notes

⚠️ High Voltage Warning: This skill does not validate electrical safety. For mains-connected circuits, consult a qualified engineer.

⚠️ No Auto-Order (Yet): Cart placement requires your explicit confirmation.

### v1.0.0

Initial release
KiCad CLI integration
Schematic/PCB preview generation
Gerber export
PCBWay quote integration
Template system

Built by PaxSwarm
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: G0HEAD
- Version: 1.0.0
## Source health
- Status: source_issue
- Known item issue.
- This item's current download entry is known to bounce back to a listing or homepage instead of returning a package file.
- Health scope: item
- Reason: not_found
- Checked at: 2026-05-04T18:14:39.732Z
- Expires at: 2026-05-05T18:14:39.732Z
- Recommended action: Open source listing
## Links
- [Detail page](https://openagent3.xyz/skills/kicad-pcb)
- [Send to Agent page](https://openagent3.xyz/skills/kicad-pcb/agent)
- [JSON manifest](https://openagent3.xyz/skills/kicad-pcb/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/kicad-pcb/agent.md)
- [Download page](https://openagent3.xyz/downloads/kicad-pcb)