plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "pcbkit",
  "version": "2.0.2",
  "description": "Design printed circuit boards with your agent as plain KiCad projects: PCBKit keeps the project, shows the board live, chooses real parts, routes the copper, checks it with KiCad's rules and makes the files a factory needs.",
  "author": {
    "name": "PCBKit",
    "email": "support@pcbkit.io",
    "url": "https://pcbkit.io"
  },
  "homepage": "https://pcbkit.io",
  "repository": "https://github.com/pcbkit-io/agent-plugin",
  "license": "MIT",
  "keywords": [
    "pcb",
    "circuit board",
    "electronics",
    "hardware",
    "kicad",
    "routing",
    "gerber"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "PCBKit",
        "shortDescription": "Design circuit boards",
        "longDescription": "PCBKit designs printed circuit boards with you. Describe what the board should do (\"a USB-C powered sensor node with an ESP32 and a temperature sensor\") and it is made as a plain KiCad project: a schematic and a board you can open in KiCad at any time. PCBKit keeps the project in your account, chooses real parts from a library of about seven million with their symbols, footprints and 3D models, routes the copper, checks the board with KiCad's own design rules, analyses power and signals, and shows the board live beside the conversation in 2D and 3D as it changes. Ask for changes in plain words (\"move the connector to the left edge\", \"make the power tracks wider\"). When the board is ready it makes the files a factory needs (Gerber and drill files, the bill of materials and the placement list) and can hand them to a factory's order page. It can also design a printed enclosure for the board, checked for fit against the board, with the files to print.\n\nA PCBKit account is needed: sign in once when the plugin asks, and your boards are kept with it, here and at pcbkit.io. Boards made with the earlier PCBKit are there too, converted to KiCad projects.\n\nLimits: two-sided and multilayer boards of everyday size and density; very dense or high-speed boards may not route completely, and PCBKit says which connections are missing. Review every design before you order it.",
        "developerName": "PCBKit",
        "category": "Developer Tools",
        "capabilities": [
          "Design circuit boards",
          "Choose real parts",
          "Route and check",
          "Export files for a factory"
        ],
        "websiteURL": "https://pcbkit.io",
        "supportURL": "https://pcbkit.io/support",
        "privacyPolicyURL": "https://pcbkit.io/privacy",
        "termsOfServiceURL": "https://pcbkit.io/terms",
        "defaultPrompt": [
          "Make a board with an LED that blinks every 2 seconds.",
          "Make a breakout board for a BME280 sensor with a Qwiic connector.",
          "Show me my boards."
        ],
        "brandColor": "#0A5BF0",
        "brandColorDark": "#4C8DFF",
        "composerIcon": "./assets/composer-icon.svg",
        "logo": "./assets/logo.png",
        "logoDark": "./assets/logo-dark.png"
      },
      "onboardingSkill": "./skills/setup/SKILL.md",
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "A first board from a sentence",
              "prompt": "Make a simple board with an LED that blinks every 2 seconds.",
              "tools_triggered": "new_project, bash and edit (the KiCad files), find_parts, part, route, check, show",
              "expected_behavior": "Makes a new project, writes a 555 blinker as a KiCad schematic and board with real parts from the library, shows the board beside the conversation, routes it, runs the check and says in plain words what was made, whether every connection is routed, and gives the board's link."
            },
            {
              "description": "The person's boards",
              "prompt": "Show me my boards and open the latest one.",
              "tools_triggered": "projects, show",
              "expected_behavior": "Lists the account's projects by name with when each changed, and shows the latest one's board; no ids in the answer beyond the board's link."
            },
            {
              "description": "Change a board",
              "prompt": "On the blinker board, put the LED in the middle and the connector on the left edge, then route it again.",
              "tools_triggered": "projects, bash or edit, route, check",
              "expected_behavior": "On the same project (no new one): moves the two footprints in the board file, routes again and reports whether every connection is routed and the check is clean; the board on show follows the changes."
            },
            {
              "description": "Find a real part",
              "prompt": "Find a 3.3 V regulator in stock that gives at least 500 mA and tell me its package.",
              "tools_triggered": "find_parts, part",
              "expected_behavior": "Searches the parts library, names one or two regulators that are in stock with their manufacturer part number, package and price, and says which it would use and why. Changes no project."
            },
            {
              "description": "Get it made",
              "prompt": "I want to order this board. Make the files for the factory.",
              "tools_triggered": "check, export",
              "expected_behavior": "Checks the board first and says what is still open if anything is; makes the factory's zip (Gerber and drill files, the bill of materials, the placement list), gives the download link, says what the zip holds, and asks the person to review the design before ordering."
            }
          ],
          "negative": [
            {
              "description": "Paying for an order",
              "prompt": "Order 10 of these boards and pay with my card."
            },
            {
              "description": "Unrelated writing",
              "prompt": "Write me a poem about autumn."
            },
            {
              "description": "Repairing a device",
              "prompt": "My laptop won't turn on after a coffee spill. How do I fix the motherboard?"
            }
          ]
        },
        "commerce": false,
        "commerce_description": "PCBKit does not sell products or take payments in the plugin. Handing a board to a factory opens the factory's own order page."
      },
      "publication": {
        "release_notes": "2.0.2: the package is texts only, and PCBKit draws the schematic itself with a new tool, `schematic`, from the agent's description of the parts and nets: wires between parts and a readable sheet instead of a label on every pin. Since 2.0.1 the board skill is rewritten. Before choosing parts PCBKit now asks what the device needs that nobody named (a way to read the battery, to load the program again, to test it) and settles it with you once; the schematic is written first and the board follows it; the number of layers is decided with its reasons; each step is shown as it is done (the schematic, the placement, the layers apart, the board in 3D). The check now runs KiCad's electrical rule check on the schematic and compares the board with it. New: an enclosure for the board, written as a program, checked for fit, with the files to print."
      },
      "apps": "./.app.json"
    }
  }
}