design-intent

Validate GPIO mappings and signal paths across firmware, schematic, PCB, and datasheet sources.

2|Updated Feb 8, 2026
One-click install
npx skills add https://github.com/pjcau/esp32-emu-turbo --skill design-intent
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: design-intent
Source: https://github.com/pjcau/esp32-emu-turbo/tree/main/.claude/skills/design-intent
Command: npx skills add https://github.com/pjcau/esp32-emu-turbo --skill design-intent

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Design Intent Adversary cross-checks GPIO mappings, nets, power chains, and signal paths across firmware, schematic, PCB, and datasheet sources to identify lost connections and inconsistencies that can cause failures in hardware designs.

Core Features & Use Cases

  • Cross-source validation: maps GPIOs, nets, and power chains across firmware/schematic/PCB/datasheet sources to ensure end-to-end signal paths are complete.
  • Inconsistency detection: hunts for orphan nets, duplicate GPIO usage, and missing signal paths.
  • Comprehensive test suite: enumerates 18 checks across GPIO, power, display, audio, SD/USB chains, and cross-component signals to catch edge cases before release.
  • PCB-review integration: complements /pcb-review workflows to harden designs prior to manufacturing.

Quick Start

Run the adversary to verify design intent by executing python3 scripts/verify_design_intent.py to perform all 18 tests.

Frequently Asked Questions about design-intent

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

FAQPage Schema
How do I verify GPIO mappings across firmware, schematic, and PCB sources?

To verify GPIO mappings across firmware, schematic, and PCB sources, run an automated design intent adversary. It cross-checks board_config.h against schematic and PCB caches to ensure end-to-end signal paths are complete and consistent.

What causes orphan nets and duplicate GPIO usage in PCB designs?

Orphan nets and duplicate GPIO usage occur when firmware configurations and hardware schematics diverge during development. A design intent adversary detects these inconsistencies by hunting for missing signal paths and conflicting pin assignments across multiple sources.

How do I check power and ground integrity before a PCB release?

Check power and ground integrity before a PCB release by running an automated validation suite. It cross-references power chains across datasheet specs, firmware, and PCB layouts to identify breaks or inconsistencies in the power delivery network.

Can I validate cross-component signal routing for SD, USB, and audio chains automatically?

Yes, you can validate cross-component signal routing for SD, USB, and audio chains automatically. The design intent validation process enumerates 18 specific tests across these interfaces to catch edge cases and verify signal integrity prior to manufacturing.

Do I need datasheet specifications to validate hardware design intent?

Yes, datasheet specifications are required to validate hardware design intent. The validation process uses datasheet_specs.py alongside firmware and PCB caches to confirm that component configurations match manufacturer guidelines and ensure correct signal routing.

What is the best way to integrate design intent checks with a PCB review workflow?

The best way to integrate design intent checks with a PCB review workflow is to run the validation scripts prior to manufacturing. This complements standard PCB review processes by hardening the design and coordinating the firmware and hardware source-of-truth.