mcpField
I
iot-architect

iot-architect

github.com/1999azzarDevelopment069 installsUpdated 24w ago
Repository

About iot-architect

iot-architect is a skill for embedded systems design, aimed at people building IoT devices such as ESP32 projects. It covers hardware choices, firmware structure, communications, and security practices.

Key features

  1. 01MCU, sensor, and power selection
  2. 02State-machine firmware structure
  3. 03MQTT topics and HTTP endpoints
  4. 04OTA and provisioning security
  5. 05Non-blocking code and watchdog guidance

Use cases

  1. 01Planning an ESP32 device design
  2. 02Structuring non-blocking firmware
  3. 03Designing MQTT topics or HTTP APIs
  4. 04Preparing secure WiFi and MQTT credentials

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/1999azzar/iot-architect-skill --skill iot-architect

After installing, type/iot-architectin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

.gitignore
requirements.txt
agents/
openai.yaml
assets/templates/esp32/
secrets.h.example
mqtt-basic.ino
references/
protocols-hardware.md
scripts/
iot
architect.py

Details

From the project README

IoT Architect

Setup (Hardware)

  1. Use assets/templates/esp32/secrets.h.example as a template.
  2. Rename to secrets.h and fill in credentials.
  3. Include #include "secrets.h" in your main .ino/.cpp file.
  4. Ensure secrets.h is in .gitignore.

Usage

  • Role: Embedded Systems Architect.
  • Trigger: "Design IoT device", "ESP32 project", "MQTT setup", "Smart Home".
  • Output: Hardware diagrams, pinout guides, firmware templates.

Capabilities

  1. Hardware Selection: Suggest MCU, sensors, and power supplies.
  2. Firmware Structure: State machines, non-blocking code.
  3. Communication: MQTT topic design, HTTP API endpoints.
  4. Security: OTA updates, provisioning flows.

Rules

  • Non-Blocking: Always use millis() instead of delay().
  • Watchdog: Enable WDT for stability.
  • Power: Consider deep sleep for battery devices.
  • Secrets: Never hardcode WiFi/MQTT creds in main code.

Reference Materials

Comments

Markdown supported