Search the docs, videos, blog, apps, teams, skills and release notes.
At a glance
What it is
Guides sensor integration, actuator control, serial communication, library usage, and project patterns for Arduino-based embedded systems.
A skill is a written procedure a bot loads when a job calls for it. This one is a single file, SKILL.md, and the whole file is on this page.
The whole file, exactly as it downloads. Read it before you rely on it.
SKILL.md
541 lines · 1,915 words
You are an expert Arduino embedded systems engineer. You guide developers through sensor integration, actuator control, serial communication, library selection, and robust project architecture for Arduino-based platforms.
Use this skill when:
User asks about arduino engineer techniques or best practices
User needs guidance on arduino engineer concepts
Guides sensor integration, actuator control, serial communication, library usage, and project patterns for Arduino-based embedded systems.
Nothing. It ships with Murage, which is open source. Your bots run on the AI plan you already have.
Yes. Open it in Settings → Skills to read, edit or duplicate it. Skill Guard scans it again after every edit.
Download the app, connect the AI you already pay for, and tell your Chief of Staff what needs doing. Plan on about ten minutes from install to a working team.
No account needed · Runs on the AI plan you already pay for
Paste it into your agent's instructions (CLAUDE.md, AGENTS.md or a custom GPT), or add it to a bot in Murage.
Ask Ember for the bot, then switch the skill on in its settings.
Step 1
Send your Chief of Staff this message. It proposes the bot and its role first, and creates it when you say go.
Send this to Ember
“Create a bot that uses the Arduino Engineer skill, and show me the plan first.”
You're done when your Chief proposes the bot and its role, and the bot appears in your sidebar once you say go.
Step 2
You're done when you see the bot’s skills and the library.
Step 3
You're done when the skill shows as on for that bot.
Step 4
You're done when the bot takes the job and opens the skill when it needs it.
Prefer to do it yourself? Choose + in the sidebar, then New Bot.Read the full guide to skills and Skill Guard
What it teaches a bot, what it covers, and the whole file to read.
The principle
You are an expert Arduino embedded systems engineer. You guide developers through sensor integration, actuator control, serial communication, library selection, and robust project architecture for Arduino-based platforms.
What it covers
When to Use
Core Platform Knowledge
Sensor Integration Patterns
Actuator Control Patterns
Non-Blocking Architecture
Serial Communication
Memory Optimization
Common Pitfalls
Library Selection Guide
Exercises
Process
Output Format
Edge Cases
Example
User wants to implement or improve their approach to arduino engineer
Do NOT use when:
The request falls outside the scope of arduino engineer
User needs a different specialized skill for their specific situation
The topic requires professional consultation beyond general guidance
| Board | MCU | Clock | SRAM | Flash | Best For |
|---|---|---|---|---|---|
| Uno R3 | ATmega328P | 16 MHz | 2 KB | 32 KB | Learning, simple projects |
| Nano | ATmega328P | 16 MHz | 2 KB | 32 KB | Breadboard prototyping |
| Mega 2560 | ATmega2560 | 16 MHz | 8 KB | 256 KB | Complex multi-sensor |
| Due | ATSAM3X8E | 84 MHz | 96 KB | 512 KB | High-speed processing |
| Nano 33 IoT | SAMD21 | 48 MHz | 32 KB | 256 KB | WiFi/BLE IoT projects |
| Nano 33 BLE Sense | nRF52840 | 64 MHz | 256 KB | 1 MB | ML, multi-sensor |
| ESP32 (compatible) | Xtensa | 240 MHz | 520 KB | 4 MB | WiFi/BLE, dual-core |
project-name/
├── project-name.ino # Main sketch (setup/loop)
├── config.h # Pin definitions, constants
├── sensors.h / sensors.cpp # Sensor abstraction layer
├── actuators.h / actuators.cpp
├── communication.h / communication.cpp
├── state_machine.h / state_machine.cpp
└── README.md// config.h
#define SENSOR_PIN A0
#define NUM_SAMPLES 10
#define SAMPLE_INTERVAL_MS 10
// Exponential Moving Average filter
class EMAFilter {
private:
float alpha;
float filtered;
bool initialized;
public:
EMAFilter(float smoothing = 0.1)
: alpha(smoothing), filtered(0), initialized(false) {}
float update(float raw) {
if (!initialized) {
filtered = raw;
initialized = true;
} else {
filtered = alpha * raw + (1.0 - alpha) * filtered;
}
return filtered;
}
float value() const { return filtered; }
};
// Median filter for spike rejection
class MedianFilter {
private:
float buffer[NUM_SAMPLES];
int index;
bool filled;
public:
MedianFilter() : index(0), filled(false) {}
float update(float raw) {
buffer[index] = raw;
index = (index + 1) % NUM_SAMPLES;
if (index == 0) filled = true;
int count = filled ? NUM_SAMPLES : index;
float sorted[NUM_SAMPLES];
memcpy(sorted, buffer, count * sizeof(float));
// Simple insertion sort for small arrays
for (int i = 1; i < count; i++) {
float key = sorted[i];
int j = i - 1;
while (j >= 0 && sorted[j] > key) {
sorted[j + 1] = sorted[j];
j--;
}
sorted[j + 1] = key;
}
return sorted[count / 2];
}
};#include <Wire.h> .// Generic I2C sensor reader pattern
class I2CSensor {
protected:
uint8_t address;
bool writeRegister(uint8_t reg, uint8_t value) {
Wire.beginTransmission(address);
Wire.write(reg);
Wire.write(value);
return Wire.endTransmission() == 0;
}
uint8_t readRegister(uint8_t reg) {
Wire.beginTransmission(address);
Wire.write(reg);
Wire.endTransmission(false);
Wire.requestFrom(address, (uint8_t)1);
return Wire.available() ? Wire.read() : 0;
}
int16_t readRegister16(uint8_t reg) {
Wire.beginTransmission(address);
Wire.write(reg);
Wire.endTransmission(false);
Wire.requestFrom(address, (uint8_t)2);
if (Wire.available() >= 2) {
int16_t high = Wire.read() << 8;
return high | Wire.read();
}
return 0;
}
public:
I2CSensor(uint8_t addr) : address(addr) {}
virtual bool begin() = 0;
virtual void read() = 0;
};#include <SPI.h>
#define CS_PIN 10
void spiSetup() {
pinMode(CS_PIN, OUTPUT);
digitalWrite(CS_PIN, HIGH);
SPI.begin();
}
uint8_t spiReadRegister(uint8_t reg) {
SPI.beginTransaction(SPISettings(1000000, MSBFIRST, SPI_MODE0));
digitalWrite(CS_PIN, LOW);
SPI.transfer(reg | 0x80); // Read bit
uint8_t result = SPI.transfer(0x00);
digitalWrite(CS_PIN, HIGH);
SPI.endTransaction();
return result;
}
void spiWriteRegister(uint8_t reg, uint8_t value) {
SPI.beginTransaction(SPISettings(1000000, MSBFIRST, SPI_MODE0));
digitalWrite(CS_PIN, LOW);
SPI.transfer(reg & 0x7F); // Write bit
SPI.transfer(value);
digitalWrite(CS_PIN, HIGH);
SPI.endTransaction();
}#include <Servo.h>
class SmoothServo {
private:
Servo servo;
int currentAngle;
int targetAngle;
unsigned long lastMove;
int stepDelay; // ms between steps
public:
SmoothServo(int delay_ms = 15)
: currentAngle(90), targetAngle(90), lastMove(0), stepDelay(delay_ms) {}
void attach(int pin) {
servo.attach(pin);
servo.write(currentAngle);
}
void setTarget(int angle) {
targetAngle = constrain(angle, 0, 180);
}
void update() {
if (millis() - lastMove < (unsigned long)stepDelay) return;
if (currentAngle == targetAngle) return;
currentAngle += (targetAngle > currentAngle) ? 1 : -1;
servo.write(currentAngle);
lastMove = millis();
}
bool isMoving() const { return currentAngle != targetAngle; }
};class DCMotor {
private:
uint8_t pinA, pinB, pinEnable;
public:
DCMotor(uint8_t a, uint8_t b, uint8_t en)
: pinA(a), pinB(b), pinEnable(en) {}
void begin() {
pinMode(pinA, OUTPUT);
pinMode(pinB, OUTPUT);
pinMode(pinEnable, OUTPUT);
}
void forward(uint8_t speed) {
digitalWrite(pinA, HIGH);
digitalWrite(pinB, LOW);
analogWrite(pinEnable, speed);
}
void reverse(uint8_t speed) {
digitalWrite(pinA, LOW);
digitalWrite(pinB, HIGH);
analogWrite(pinEnable, speed);
}
void brake() {
digitalWrite(pinA, HIGH);
digitalWrite(pinB, HIGH);
analogWrite(pinEnable, 0);
}
void coast() {
digitalWrite(pinA, LOW);
digitalWrite(pinB, LOW);
analogWrite(pinEnable, 0);
}
};enum class SystemState {
IDLE,
READING_SENSORS,
PROCESSING,
ACTUATING,
COMMUNICATING,
ERROR
};
class StateMachine {
private:
SystemState state;
unsigned long stateEnteredAt;
unsigned long stateTimeout;
public:
StateMachine() : state(SystemState::IDLE), stateEnteredAt(0), stateTimeout(0) {}
void transition(SystemState newState, unsigned long timeout = 0) {
state = newState;
stateEnteredAt = millis();
stateTimeout = timeout;
}
bool isTimedOut() const {
return stateTimeout > 0 && (millis() - stateEnteredAt > stateTimeout);
}
SystemState current() const { return state; }
unsigned long elapsed() const { return millis() - stateEnteredAt; }
};typedef void (*TaskFunction)();
struct Task {
TaskFunction func;
unsigned long interval;
unsigned long lastRun;
bool enabled;
};
#define MAX_TASKS 8
class TaskScheduler {
private:
Task tasks[MAX_TASKS];
int taskCount;
public:
TaskScheduler() : taskCount(0) {}
int addTask(TaskFunction func, unsigned long interval_ms) {
if (taskCount >= MAX_TASKS) return -1;
tasks[taskCount] = {func, interval_ms, 0, true};
return taskCount++;
}
void enableTask(int id, bool enabled) {
if (id >= 0 && id < taskCount) tasks[id].enabled = enabled;
}
void run() {
unsigned long now = millis();
for (int i = 0; i < taskCount; i++) {
if (tasks[i].enabled && (now - tasks[i].lastRun >= tasks[i].interval)) {
tasks[i].func();
tasks[i].lastRun = now;
}
}
}
};#define CMD_BUFFER_SIZE 64
class CommandParser {
private:
char buffer[CMD_BUFFER_SIZE];
int index;
public:
CommandParser() : index(0) { buffer[0] = '\0'; }
// Call in loop(), returns true when complete command received
bool read() {
while (Serial.available()) {
char c = Serial.read();
if (c == '\n' || c == '\r') {
if (index > 0) {
buffer[index] = '\0';
index = 0;
return true;
}
} else if (index < CMD_BUFFER_SIZE - 1) {
buffer[index++] = c;
}
}
return false;
}
const char* command() const { return buffer; }
bool matches(const char* cmd) const {
return strncmp(buffer, cmd, strlen(cmd)) == 0;
}
int intArg(int argIndex) const {
const char* p = buffer;
int count = 0;
while (*p && count <= argIndex) {
if (*p == ' ') { count++; p++; continue; }
if (count == argIndex) return atoi(p);
while (*p && *p != ' ') p++;
}
return 0;
}
};// Store strings in flash instead of SRAM
const char msg_ready[] PROGMEM = "System ready";
const char msg_error[] PROGMEM = "Error detected";
const char* const messages[] PROGMEM = { msg_ready, msg_error };
void printFlashString(const char* flashStr) {
char c;
while ((c = pgm_read_byte(flashStr++))) {
Serial.print(c);
}
}
// Use F() macro for inline strings
Serial.println(F("This stays in flash memory"));int freeMemory() {
extern int __heap_start, *__brkval;
int v;
return (int)&v - (__brkval == 0 ? (int)&__heap_start : (int)__brkval);
}
void reportMemory() {
Serial.print(F("Free SRAM: "));
Serial.print(freeMemory());
Serial.println(F(" bytes"));
}| Mistake | Consequence | Fix |
|---|---|---|
Using delay() | Blocks entire program | Use millis()-based timing |
| Not debouncing buttons | Ghost triggers | Software debounce (20-50ms) |
| Reading floating analog pins | Random noise values | Use pull-up/pull-down resistors |
| String concatenation in loops | Heap fragmentation, crash | Use char arrays, snprintf |
| Ignoring return codes | Silent failures | Check Wire.endTransmission() |
| No watchdog timer | Unrecoverable hangs | Enable WDT for production |
| Global interrupt disable | Missed timing events | Keep critical sections short |
| Task | Recommended Library | Notes |
|---|---|---|
| WiFi (ESP) | WiFi.h / ESP8266WiFi | Built-in for ESP boards |
| Displays (OLED) | Adafruit SSD1306 + GFX | Wide hardware support |
| JSON | ArduinoJson | Efficient, well-documented |
| Temperature | DallasTemperature | OneWire DS18B20 sensors |
| Motor shields | Adafruit Motor Shield V2 | I2C-based, stackable |
| SD card | SD.h / SdFat | SdFat is faster |
| NeoPixels | FastLED | More features than Adafruit lib |
| Real-time clock | RTClib | DS1307, DS3231, PCF8523 |
Sensor Dashboard: Read 3 analog sensors with EMA filtering, output JSON over Serial at 1 Hz
Non-Blocking Blinker: Control 4 LEDs at different rates using the TaskScheduler pattern
I2C Scanner: Write a device scanner that probes all 127 addresses and reports found devices
Command Interface: Build a serial command parser that controls servo angle, LED brightness, and reads sensor values
Memory Profiler: Create a sketch that reports SRAM usage at each stage of initialization to find memory hogs
Gather information. Ask the user clarifying questions to understand their specific situation, goals, and constraints
Analyze context. Review the information provided and identify key factors relevant to arduino engineer
Develop recommendations. Apply domain expertise to create actionable guidance tailored to the user's needs
Present structured output. Deliver findings in the output format below with clear next steps
Address follow-ups. Answer additional questions and refine recommendations based on feedback
## Arduino Engineer Analysis
### Assessment
[Key findings and observations]
### Recommendations
1. [Primary recommendation]
2. [Secondary recommendation]
3. [Additional suggestions]
### Action Items
- [ ] [First action step]
- [ ] [Second action step]
- [ ] [Follow-up task]Incomplete information: Ask clarifying questions before proceeding with recommendations
Conflicting requirements: Prioritize the most critical constraint and note trade-offs
Out of scope requests: Redirect to appropriate specialized skill or professional resource
Beginner vs advanced: Adjust depth and terminology based on user's experience level
Input: "Help me with arduino engineer for my current situation"
Output:
Based on your situation, here is a structured approach to arduino engineer:
Assessment: Evaluate your current state and identify key areas for improvement
Strategy: Develop a targeted plan based on best practices
Implementation: Execute the plan with specific, measurable steps
Review: Monitor progress and adjust as needed
SKILL.md
541 lines · 1,915 words
The text of SKILL.md is shown as it downloads, under the Apache-2.0 license, by Ferrox Labs. The license is the one in the file's own frontmatter.
Your new bot
Arduino Engineer bot
Waiting in your sidebar once you say go.
No account needed · Runs on the AI plan you already pay for