@fingerskier/pi-skidl

SKiDL circuit-design MCP plugin for Pi with a self-bootstrapping Python server

Packages

Package details

extensionskillprompt

Install @fingerskier/pi-skidl from npm and Pi will load the resources declared by the package manifest.

npm report
$ pi install npm:@fingerskier/pi-skidl
Package
@fingerskier/pi-skidl
Version
2026.5.12
Published
May 11, 2026
Downloads
43/mo · 9/wk
Author
fingerskier
License
MIT
Types
extension, skill, prompt
Size
243.1 KB
Dependencies
1 dependency · 0 peers
Pi manifest JSON
{
  "extensions": [
    "./extensions/skidl.ts"
  ],
  "skills": [
    "./skills"
  ],
  "prompts": [
    "./prompts"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

SKiDL Pi Plugin

Pi package port of skidl-claude-plugin.

This package bundles the upstream Python MCP server source and a Pi extension that exposes its circuit-design tools with a skidl_ prefix. The first MCP start creates a private venv under ~/.pi/agent/data/skidl/venv, installs this package into it, then runs skidl-mcp.

Install

pi install npm:@fingerskier/pi-skidl
# local workspace clone
pi install ./packages/pi-skidl
# one run only
pi -e npm:@fingerskier/pi-skidl

Host requirements: Python 3.10+ available as python (or set SKIDL_PYTHON) and KiCad installed for symbol libraries. SVG generation also requires netlistsvg available on PATH.

Tools

Run skidl_mcp_status in Pi to list loaded tools. Expected tools include:

  • skidl_create_circuit, skidl_list_circuits, skidl_switch_circuit
  • skidl_add_part, skidl_search_parts, skidl_list_parts, skidl_get_part_info
  • skidl_create_net, skidl_connect, skidl_connect_pins, skidl_create_bus
  • skidl_run_erc, skidl_check_connections, skidl_validate_footprints
  • skidl_generate_netlist, skidl_generate_svg, skidl_generate_bom, skidl_generate_kicad_schematic, skidl_export_python

Configuration

  • SKIDL_MCP_AUTOLOAD=0 disables startup MCP discovery.
  • SKIDL_PI_DATA=/path/to/data controls the venv/cache directory.
  • SKIDL_PYTHON=python3 selects the Python executable.
  • SKIDL_MCP_COMMAND=/path/to/skidl-mcp runs an external server instead of the bundled launcher.
  • SKIDL_MCP_ARGS="..." passes extra arguments to the launcher or command override.

Development checks

pnpm --filter @fingerskier/pi-skidl run test
pnpm --filter @fingerskier/pi-skidl run build
pnpm --filter @fingerskier/pi-skidl pack --dry-run

The package test script runs manifest validation plus the Python pytest suite in an isolated .venv-test unless SKIDL_TEST_PYTHON is set to an existing interpreter.

Skills and Prompts

  • /skill:skidl loads circuit-design workflow guidance.
  • Prompt templates such as /skidl-voltage-divider, /skidl-power-supply, /skidl-microcontroller, and /skidl-usb-interface mirror the upstream design templates.

Upstream Notes

See README.upstream.md for the original Claude plugin documentation.