CtrlK
BlogDocsLog inGet started
Tessl Logo

firmware-analyst

Expert firmware analyst specializing in embedded systems, IoT security, and hardware reverse engineering.

48

Quality

51%

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

Fix and improve this skill with Tessl

tessl review fix ./plugins/AI-Agents-Safe-Coding-Skills-claude/skills/firmware-analyst/SKILL.md

The canonical home for this skill is firmware-analyst in administrakt0r/AI-Agents-Safe-Coding-Skills

SKILL.md
Quality
Evals
Security

Quality

Content

53%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.

The content is rich with executable firmware-analysis commands and a reasonable phased workflow, but it is undermined by unrelated templated boilerplate, missing validation checkpoints on destructive operations, a broken/dangling file reference, and bulk tool reference material inlined into SKILL.md that should be split into separate files.

Suggestions

Remove the generic 'Use this skill when / Do not use this skill when / Instructions' boilerplate (which only repeats 'download from vendor') and replace with firmware-specific guidance, or align it to the actual skill scope.

Add explicit validation checkpoints after risky steps (e.g., verify binwalk extraction output exists before Phase 3; confirm dd dump size matches flash size before analysis) to introduce verify-then-proceed feedback loops.

Move the Tool Proficiency, Common Vulnerability Classes, and Emulation Setup sections into separate reference files under references/ and link to them from SKILL.md, and either create or remove the referenced resources/implementation-playbook.md.

DimensionReasoningScore

Conciseness

The body is mostly dense command/tool reference material, but it carries generic templated boilerplate ('Use this skill when... download from vendor', 'Do not use this skill when', 'Instructions') that is unrelated padding, plus long plain-text tool-proficiency lists describing tools Claude largely already knows; this fits 'mostly efficient but includes some unnecessary explanation' rather than the lean 4-anchor.

3 / 5

Actionability

It provides substantial executable bash (binwalk, dd, unsquashfs, chroot+qemu, cross-compilation, Ghidra architecture specs) that is largely copy-paste ready across common cases, matching 'mostly executable guidance; concrete code with minor gaps'; not a 5 because several sections (Hardware Methods, Tool Proficiency, Common Vulnerability Classes) are descriptive lists rather than runnable instruction.

4 / 5

Workflow Clarity

Phases 1-4 give a recognizable sequence plus a checklist and reporting template, but destructive/risky operations (dd if=/dev/mtd0, chip-off, binwalk --extract, sudo chroot) have no validation checkpoints or verify-then-proceed feedback loops, so per the rubric's destructive-operation cap workflow_clarity cannot exceed 3.

3 / 5

Progressive Disclosure

No bundle directories (references/, scripts/, assets/) exist, yet the body references a nonexistent 'resources/implementation-playbook.md' (a dangling reference), and hundreds of lines of tool lists and workflows that belong in separate reference files are inlined into one monolithic SKILL.md; this matches 'minimal structure; content that belongs in separate files is inlined; references buried/broken' more closely than the 3-anchor.

2 / 5

Total

12

/

20

Passed

Description

48%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.

The description identifies a distinct, well-scoped niche but is expressed as a role label rather than a capability statement, with no concrete actions and no 'Use when' trigger guidance. Specificity and completeness are the weakest dimensions and would benefit most from revision.

Suggestions

Rewrite the description to lead with concrete verbs (e.g., 'Extracts, analyzes, and reverse-engineers firmware...') instead of the generic 'Expert firmware analyst specializing in' role framing.

Add an explicit trigger clause, e.g. 'Use when analyzing firmware images, extracting embedded filesystems, or hunting vulnerabilities in IoT devices.'

Include natural user-side terms and file extensions (firmware image, .bin, binwalk, firmware update) alongside the technical domain labels.

DimensionReasoningScore

Specificity

The description names the domain ('embedded systems, IoT security, and hardware reverse engineering') but uses only generic role language ('Expert firmware analyst specializing in...') with no concrete actions like extract, analyze, or identify, matching the 'names domain but actions minimal/generic' anchor rather than the 3-anchor which requires 1-2 concrete verbs.

2 / 5

Completeness

A clear 'what' is present (firmware analyst specializing in embedded/IoT/hardware RE) but there is no 'Use when...' clause or equivalent trigger guidance, so per the rubric guideline completeness is capped at 3 ('clear what but when missing or only weakly implied'); it is not a 2 because the 'what' is concrete, not vague.

3 / 5

Trigger Term Quality

It includes relevant keywords ('firmware', 'embedded systems', 'IoT security', 'hardware reverse engineering') but leans technical and omits common user phrasings such as 'analyze firmware' or 'extract firmware', fitting the 'some relevant keywords but missing common variations' anchor; not a 4 because natural user-side synonyms are largely absent.

3 / 5

Distinctiveness Conflict Risk

'Firmware analyst' and 'hardware reverse engineering' denote a clear niche unlikely to collide with general skills, with only minor overlap risk against broader security/RE skills, matching the 'mostly distinct; minor overlap risk' anchor; not a 5 because the description lacks the explicit trigger phrases that would fully lock in the niche.

4 / 5

Total

12

/

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.

Validation15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository
administrakt0r/AI-Agents-Safe-Coding-Skills
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.