CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

embedded-iot-mentor

Mentor for embedded and IoT hardware projects. Helps select MCUs, dev boards, and toolchains, decides where sensor readings end up (phone, PC, dashboard, or alert), and gives time/cost estimates and a phased build plan from breadboard MVP to production PCB. Use when the user mentions embedded, IoT, microcontroller, ESP32, STM32, Arduino, Raspberry Pi Pico, firmware, PCB, KiCad, EasyEDA, PlatformIO, MQTT, Home Assistant, ESPHome, Grafana, an IoT dashboard, seeing sensor data on a phone, or asks for hardware tool recommendations, project planning, or cost/time estimates for an electronics project.

72

Quality

90%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

The canonical home for this skill is embedded-iot-mentor in alirezarezvani/claude-skills

SKILL.md
Quality
Evals
Security

Quality

Content

77%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-crafted advisory skill body: lean, sharply opinionated guidance with concrete picks, explicit output shaping (caps, drop conditions, exit criteria), and a strong worked example. Its one real defect is external: the body twice defers substantive detail to `references/hardware-selection.md`, which is absent from the bundle, leaving the promised power-budget and per-family data unreachable. Internal redundancy of a few core rules is a minor trim opportunity.

Suggestions

Add the missing `references/hardware-selection.md` (per-family power figures, PIO, toolchain notes, duty-cycle/power-budget arithmetic) — or, if the bundle is intentionally single-file, inline the minimal version of those facts and remove the two citations to it.

State each core rule once (reuse-first firmware, no port forwards, regional buy-ability) and let the Anti-Patterns section reference it, rather than repeating the full rule in 'Core style rules', the recommendation sections, and Anti-Patterns.

Tighten the toolchain section's 'Where code is written' paragraph — the four items (serial console, debugger, layout, version control) could be a compact one-line list, saving tokens without losing guidance.

DimensionReasoningScore

Conciseness

The body is dense and directive — tables, one-line rules, and no explaining of concepts Claude already knows (no 'what is an MCU' padding). It falls short of 5 due to deliberate repetition of the same rules in multiple sections: the reuse-first principle appears in 'Core style rules' ('Firmware that already exists beats firmware to be written'), again in the toolchain section, and again in Anti-Patterns; 'never a port forward' and 'Buy-ability is regional' are each stated twice. Score 3 would require noticeably unnecessary explanation, which is not the case — the redundancy is reinforcement, not padding.

4 / 5

Actionability

Guidance is unusually concrete for an instruction-only skill: named primary/alternative picks per situation (ESP32 DevKit vs Pico W; KiCad vs EasyEDA; Home Assistant + ESPHome vs MQTT + Node-RED), named ready-made firmware (ESPHome, Meshtastic, Tasmota, WLED), named sources (LCSC / Digi-Key / JLCPCB), and a worked example with specific parts (DS18B20/SHT31, ESP32 devkit, Nabu Casa tunnel). It stops short of 5 because several directives defer their substance to `references/hardware-selection.md` — e.g. 'the duty-cycle arithmetic in references/hardware-selection.md decides the battery' — and that file does not exist in the bundle, so the cited executable detail (power-budget arithmetic, per-family power figures) is unavailable anywhere.

4 / 5

Workflow Clarity

The process is clearly sequenced with explicit checkpoints: no-details intake (questions one at a time, 'ask only what is still missing') → six-part recommendation process → output-format table with per-section caps and 'Drop it when' conditions → worked example. The MVP plan step explicitly requires 'exit criteria' per step, and 'stop after MVP unless asked' is a stated stopping rule, which together function as validation checkpoints. This is an advisory skill, so the destructive/batch validation cap does not apply. Score 4 ('minor validation gaps') is not a better fit — the drop-conditions table and exit-criteria requirement are exactly the checkpoint/checklist pattern the 5 anchor describes.

5 / 5

Progressive Disclosure

The in-body structure is good — overview, intake flow, numbered recommendation sections, output format, worked example, anti-patterns — and the body correctly defers datasheet-level detail ('per-family power figures, PIO, toolchains, power-budget arithmetic') to `references/hardware-selection.md` with a clear signal about when to cite it. However, per the guideline to score against the actual bundle structure, no `references/` directory (or any bundle file) exists, so both citations of that path are dangling. The deferred detail is neither in SKILL.md nor in any provided file, which undermines the split the structure promises. Score 4 requires 'minor organization gaps'; a referenced file that is entirely missing is a larger structural defect, so 3 fits: good signaling, broken reference reality.

3 / 5

Total

16

/

20

Passed

Description

100%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A model description: dense but not padded, third-person, with concrete capabilities on both the hardware and data-viewing sides, an explicit and broad 'Use when' trigger clause, and a clearly bounded niche. No dimension shows a gap against the top anchors.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — 'Helps select MCUs, dev boards, and toolchains, decides where sensor readings end up (phone, PC, dashboard, or alert), and gives time/cost estimates and a phased build plan from breadboard MVP to production PCB' — with comprehensive coverage and no vague filler. Anti-drift check: score 4 requires 'minor gaps in coverage'; every stated capability is named concretely, so 5 fits best.

5 / 5

Completeness

It explicitly answers both 'what' (mentor that selects MCUs/boards/toolchains, decides where readings end up, gives time/cost estimates and a phased MVP-to-production plan) and 'when' (an explicit 'Use when...' clause with concrete trigger phrases). Per the rubric guideline this is the exact 5-anchor pattern; a missing or weak 'Use when' would cap it at 3, which does not apply here.

5 / 5

Trigger Term Quality

Trigger coverage is comprehensive and natural: 'embedded, IoT, microcontroller, ESP32, STM32, Arduino, Raspberry Pi Pico, firmware, PCB, KiCad, EasyEDA, PlatformIO, MQTT, Home Assistant, ESPHome, Grafana, an IoT dashboard, seeing sensor data on a phone' plus 'hardware tool recommendations, project planning, or cost/time estimates'. These are exactly the words a user with this need would say, including synonyms and whole natural phrases. Score 4 ('a few natural terms missing') is not a better fit — no common variant is obviously absent.

5 / 5

Distinctiveness Conflict Risk

It carves out a clear niche (embedded/IoT hardware mentoring) with distinct triggers (ESP32, KiCad, ESPHome, MQTT, breadboard MVP) that would not fire for document, web, or general software skills. Not first/second person, no over-claims, minimal overlap risk with adjacent skills.

5 / 5

Total

20

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

referenced_paths_exist

Referenced path issues: 2 missing

Warning

Total

15

/

16

Passed

Repository

alirezarezvani/claude-skills

Path

.gemini/skills/embedded-iot-mentor/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.