Hardware Spec Assembly

A Claude Code plugin for defining BOMs and assembly plans for hardware projects, with first-class support for ESP32-based builds.

The plugin walks the user from a project idea to a written spec, a structured BOM, a budget, a sourcing plan, compatibility checks, wiring spec, assembly instructions, 3D-printable suggestions, and AI-generated mockups.

Skills

Skill	Purpose
onboard	First-run setup — captures location, vendors, project domains, on-hand gear, optional MCP-connected inventory.
create-hardware-spec	Build a structured spec + BOM for a new project.
bom-from-project-idea	Lightweight: free-form idea → draft BOM, no project files written.
generate-budget-approximation	Cost envelope (low/mid/high) per sourcing strategy.
suggest-sourcing-options	Per-vendor consolidated cart plan, with authenticity flags.
check-onhand-coverage	Diff BOM against the static on-hand list captured during onboarding.
check-inventory	Diff BOM against a live MCP-connected inventory system.
datasheet-lookup	Fetch and summarise official datasheets; cache locally.
compatibility-check	Voltage / logic-level / I2C address / pin count sanity checks.
generate-wiring-diagram-spec	Pin map, bus topology, power distribution, breadboard notes.
create-assembly-instructions	Ordered build steps with test gates between them.
suggest-3d-printables	Enclosures, mounts, brackets — existing models or custom specs.
export-bom-csv	CSV + clean markdown table export of the BOM.
generate-mockups	AI-generated visualisations via fal.ai nano-banana.

Data storage

• Plugin config and caches: ${CLAUDE_USER_DATA:-${XDG_DATA_HOME:-$HOME/.local/share}/claude-plugins}/hardware-spec-assembly/
• User-owned project files (specs, BOMs, mockups): a directory chosen during onboarding (default suggestion ~/Documents/Hardware-Projects/).

Installation

claude plugins install hardware-spec-assembly@danielrosehill

Then run the onboard skill.

License

MIT