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
- 01MCU, sensor, and power selection
- 02State-machine firmware structure
- 03MQTT topics and HTTP endpoints
- 04OTA and provisioning security
- 05Non-blocking code and watchdog guidance
Use cases
- 01Planning an ESP32 device design
- 02Structuring non-blocking firmware
- 03Designing MQTT topics or HTTP APIs
- 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-architectAfter installing, type/iot-architectin Claude Code to confirm it loaded.
Bundled files
References and scripts installed along with SKILL.md.
.gitignorerequirements.txtagents/openai.yamlassets/templates/esp32/secrets.h.examplemqtt-basic.inoreferences/protocols-hardware.mdscripts/iotarchitect.pyDetails
From the project READMEIoT Architect
Setup (Hardware)
- Use
assets/templates/esp32/secrets.h.exampleas a template. - Rename to
secrets.hand fill in credentials. - Include
#include "secrets.h"in your main.ino/.cppfile. - Ensure
secrets.his 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
- Hardware Selection: Suggest MCU, sensors, and power supplies.
- Firmware Structure: State machines, non-blocking code.
- Communication: MQTT topic design, HTTP API endpoints.
- Security: OTA updates, provisioning flows.
Rules
- Non-Blocking: Always use
millis()instead ofdelay(). - 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