wokwi-chip-diagram

Generate Wokwi chip.json and diagram.json files from a canonical test specification.

Updated Mar 15, 2026
One-click install
npx skills add https://github.com/mohankumargupta/skills --skill wokwi-chip-diagram-mohankumargupta
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: wokwi-chip-diagram
Source: https://github.com/mohankumargupta/skills/tree/main/wokwi-chip-diagram
Command: npx skills add https://github.com/mohankumargupta/skills --skill wokwi-chip-diagram-mohankumargupta

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) and assets (resource) components.

What problem does it solve? Manually authoring Wokwi custom chip definitions and circuit diagrams is error-prone: pin names must match the chip.json exactly, ESP32-C3 pin names use disambiguating suffixes, and attribute overrides can silently break simulation. This Skill generates both chip.json and diagram.json deterministically from a canonical test specification, with schema and lint validation. ## Core Features & Use Cases - chip.json generation: Builds a Wokwi custom chip definition (pins and environmental controls) from the device spec and validates it against the official chip JSON schema with check-jsonschema. - diagram.json generation: Extends a template diagram containing the ESP32-C3-DevKitM-1 board and custom chip, wiring buses using canonical pin assignments from the board profile and applying only environmental attributes. - Validation workflow: Runs check-jsonschema on chip.json and wokwi-cli lint on diagram.json to catch invalid pins, duplicate IDs, and schema violations. - Use Case: Given a canonical test spec for an I2C temperature sensor, produce a validated chip.json exposing a temperature control and a diagram.json wiring the chip to the ESP32-C3 primary I2C bus (GPIO4/GPIO5) with correct wire colors. ## Quick Start Generate the Wokwi chip.json and diagram.json for my device from its canonical test specification and validate both files.

Frequently Asked Questions about wokwi-chip-diagram

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a Wokwi custom chip chip.json file?▼

Define a JSON object with name, author, pins array, and controls array, then validate it against the official chip schema with check-jsonschema. Pin names must match what the diagram.json connections reference, and controls should only expose environmental inputs like temperature.

How do I generate a Wokwi diagram.json for ESP32-C3?▼

Start from a template containing the board-esp32-c3-devkitm-1 part and your custom chip, then add connections using canonical bus pins such as GPIO4/GPIO5 for primary I2C. Validate the result with wokwi-cli lint to catch invalid pin names and duplicate IDs.

Which ESP32-C3 pins should I use for I2C in Wokwi?▼

Use GPIO4 for SDA and GPIO5 for SCL as the primary I2C bus. Avoid strapping pins GPIO2, GPIO8, GPIO9 and native USB pins GPIO18/GPIO19 unless a secondary bus is genuinely required.

Why did my Wokwi custom chip stop responding on the I2C bus?▼

A common cause is overriding a fixed wiring-derived attribute, such as an I2C address set by an address strap pin, through the attrs object. Only attributes classified as environmental should receive attrs entries; wiring parameters belong in the connections array.

How do I validate Wokwi diagram.json files?▼

Run wokwi-cli lint in the directory containing diagram.json. It checks for unknown part types, invalid pin connections, duplicate IDs, and missing components before you run the simulation.