К основному содержанию
скилл CX Codex

firmware-analyst — скилл для Claude Code

Скилл firmware-analyst для экспертизы встроенного ПО, анализа прошивок IoT-устройств и поиска уязвимостей в железе. Работает с извлечением файловых систем, идентификацией бинарников и выявлением типичных ошибок в коде.

MIT 1 установок ★ 50 109 обновлён 2026-10-29

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add sickn33/agentic-awesome-skills --skill firmware-analyst -a claude-code
Открыть на GitHub

Что делает firmware-analyst

firmware-analyst помогает разбирать прошивки: выделяет встроенные файловые системы, находит в них конфигурацию и исполняемые файлы, анализирует бинарный код. Внутри — команды для binwalk (включая рекурсивное извлечение), работа с SquashFS, JFFS2, UBIFS, а также поиск типичных проблем: захардкодированные пароли, переполнения буфера, впрыск команд, отключённые отладочные интерфейсы.

Скилл требует явного подтверждения перед любым действием против реального целевого устройства или сервера — нужно указать адрес, вывести письменное разрешение собственника и согласовать конкретные команды. Без авторизации остаётся в режиме консультирования. Для работы нужны внешние скрипты (./scripts/getArch.sh, ./scripts/makeImage.sh, ./scripts/inferNetwork.sh), которые не входят в пакет: их придётся получить отдельно от автора или из уже установленной версии.

Производит анализ только в изолированной виртуальной машине без доступа к хостовым секретам и сети — это обязательно, потому что работа касается потенциально опасного кода. Найденные пароли и ключи не выводит в отчётах, данные хранит в пределах авторизованного раскрытия.

Какие задачи решает

  • Извлечь файловую систему из прошивки и найти конфиги
  • Идентифицировать архитектуру процессора в бинарнике
  • Поискать захардкодированные пароли и ключи в коде
  • Проверить бинарники на классические уязвимости (переполнение, впрыск)
  • Проанализировать вебинтерфейс устройства на предмет взлома

Примеры запросов агенту

  • Проанализируй эту прошивку на уязвимости: определи архитектуру, извлеки файловую систему, найди подозрительные строки в коде
  • Распаковай firmware.bin рекурсивно, выведи структуру — какие компоненты там есть и какая ОС используется
  • Поищи в конфигах устройства дефолтные пароли и закрытые учётные записи

Как установить firmware-analyst

1Через Skills CLI (Vercel)

npx skills add sickn33/agentic-awesome-skills --skill firmware-analyst -a claude-code

2Вручную: положить файлы

~/.claude/skills/firmware-analyst/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/firmware-analyst/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о firmware-analyst

Как установить firmware-analyst в Claude Code?

Выполни npx skills add sickn33/agentic-awesome-skills --skill firmware-analyst -a claude-code, затем открой ~/.claude/skills/firmware-analyst/SKILL.md для проверки. Для других платформ команда отличается: GitHub Copilot — gh skill install sickn33/agentic-awesome-skills firmware-analyst, Cursor — npx skills add sickn33/agentic-awesome-skills --skill firmware-analyst -a cursor.

Что делает firmware-analyst?

Помогает анализировать прошивки встроенных систем: извлекает файловые системы, выявляет архитектуру, ищет захардкодированные учётные данные, находит команды впрыска и переполнения буфера, проверяет отладочные интерфейсы. Работает только с разрешения собственника целевой системы.

Нужны ли дополнительные инструменты для работы скилла?

Да, скилл использует внешние скрипты (./scripts/getArch.sh, ./scripts/makeImage.sh, ./scripts/inferNetwork.sh), которые не входят в пакет. Их нужно получить отдельно у автора или из существующей установки. Работа обязательно выполняется в изолированной виртуальной машине без доступа к сетевым ресурсам и хостовым данным.

Исходный текст

SKILL.md · MIT
---
name: firmware-analyst
description: Expert firmware analyst specializing in embedded systems, IoT security, and hardware reverse engineering.
risk: offensive
source: community
date_added: '2026-02-27'
---
## Supporting material availability

This catalog copy contains the inline guidance below, but does not include the following supporting paths. They are external prerequisites, not bundled files:

- `./scripts/getArch.sh`
- `./scripts/makeImage.sh`
- `./scripts/inferNetwork.sh`

Ask for the original supporting material or an existing installation before using a step that depends on these paths; this catalog does not identify a verified download source for them. Resolve each path relative to that installation, inspect its contents, and verify any applicable license and execution prerequisites. Do not run a command or claim a referenced procedure was followed until its required file exists. Do not fabricate the missing scripts or treat an unrelated file with the same name as equivalent. Independent steps fully documented here can proceed within the user’s authorized scope; report any dependent step as unavailable.


> **⚠️ AUTHORIZED USE ONLY**
> This skill is for educational purposes or authorized security assessments only.
> You must have explicit, written permission from the system owner before using this tool.
> Misuse of this tool is illegal and strictly prohibited.

> **Mandatory confirmation gate**
> Before running any command that probes, exploits, changes, persists on, extracts data from, or attempts credential access against a target:
> 1. Ask the user to state the exact target URL, IP, account, or resource.
> 2. Ask the user to confirm written authorization and the permitted scope.
> 3. Show the exact command(s) and explain their expected effect.
> 4. Wait for explicit confirmation in the current conversation.
>
> Without that confirmation, remain read-only and provide defensive guidance only. Prefer a sandbox, disposable VM, or controlled lab.

## Firmware acquisition (illustrative)

```bash
# Download only from the verified vendor HTTPS source; preserve its hash/signature.
# Substitute the actual approved URL, not this placeholder.
wget https://vendor.example.invalid/firmware/update.bin

# Extract from device via debug interface
# UART console access
screen /dev/ttyUSB0 115200
# Copy firmware partition
dd if=/dev/mtd0 of=/tmp/firmware.bin

# Extract via network protocols
# TFTP during boot
# HTTP/FTP from device web interface
```

### Hardware Methods
```
UART access         - Serial console connection
JTAG/SWD           - Debug interface for memory access
SPI flash dump     - Direct chip reading
NAND/NOR dump      - Flash memory extraction
Chip-off           - Physical chip removal and reading
Logic analyzer     - Protocol capture and analysis
```

## Use this skill when

- Reviewing authorized embedded firmware images, extracted filesystems or binary security properties
- Planning controlled acquisition, emulation and remediation-oriented reporting

## Do not use this skill when

- The task is unrelated to download from vendor
- You need a different domain or tool outside this scope

## Instructions

- Clarify goals, constraints, and required inputs.
- Apply relevant best practices and validate outcomes.
- Provide actionable steps and verification.

## Extraction and emulation isolation

Keep original firmware immutable and record hash/source/version. Extract untrusted images as an unprivileged user in a disposable VM, with output/resource limits and no host secrets or external network access. `chroot` is not a security sandbox: the rootful emulation examples must run only inside that isolated VM. Review extraction symlinks/device nodes and tool versions before access. Do not print or reuse discovered credentials; redact reports and keep findings within the authorized disclosure scope.

## Firmware Analysis Workflow

### Phase 1: Identification
```bash
# Basic file identification
file firmware.bin
binwalk firmware.bin

# Entropy analysis (detect compression/encryption)
# Binwalk v3: generates entropy PNG graph
binwalk --entropy firmware.bin
binwalk -E firmware.bin  # Short form

# Identify embedded file systems and auto-extract
binwalk --extract firmware.bin
binwalk -e firmware.bin  # Short form

# String analysis
strings -a firmware.bin | grep -i "password\|key\|secret"
```

### Phase 2: Extraction
```bash
# Binwalk v3 recursive extraction (matryoshka mode)
binwalk --extract --matryoshka firmware.bin
binwalk -eM firmware.bin  # Short form

# Extract to custom directory
binwalk -e -C ./extracted firmware.bin

# Verbose output during recursive extraction
binwalk -eM --verbose firmware.bin

# Manual extraction for specific formats
# SquashFS
unsquashfs filesystem.squashfs

# JFFS2
jefferson filesystem.jffs2 -d output/

# UBIFS
ubireader_extract_images firmware.ubi

# YAFFS
unyaffs filesystem.yaffs

# Cramfs
cramfsck -x output/ filesystem.cramfs
```

### Phase 3: File System Analysis
```bash
# Explore extracted filesystem
find . -name "*.conf" -o -name "*.cfg"
find . -name "passwd" -o -name "shadow"
find . -type f -executable

# Find hardcoded credentials
grep -r "password" .
grep -r "api_key" .
grep -rn "BEGIN RSA PRIVATE KEY" .

# Analyze web interface
find . -name "*.cgi" -o -name "*.php" -o -name "*.lua"

# Check for vulnerable binaries
checksec --dir=./bin/
```

### Phase 4: Binary Analysis
```bash
# Identify architecture
file bin/httpd
readelf -h bin/httpd

# Load in Ghidra with correct architecture
# For ARM: specify ARM:LE:32:v7 or similar
# For MIPS: specify MIPS:BE:32:default

# Set up cross-compilation for testing
# ARM
arm-linux-gnueabi-gcc exploit.c -o exploit
# MIPS
mipsel-linux-gnu-gcc exploit.c -o exploit
```

## Common Vulnerability Classes

### Authentication Issues
```
Hardcoded credentials     - Default passwords in firmware
Backdoor accounts         - Hidden admin accounts
Weak password hashing     - MD5, no salt
Authentication bypass     - Logic flaws in login
Session management        - Predictable tokens
```

### Command Injection
```c
// Vulnerable pattern
char cmd[256];
sprintf(cmd, "ping %s", user_input);
system(cmd);

// Test payloads
; id
| cat /etc/passwd
`whoami`
$(id)
```

### Memory Corruption
```
Stack buffer overflow    - strcpy, sprintf without bounds
Heap overflow           - Improper allocation handling
Format string           - printf(user_input)
Integer overflow        - Size calculations
Use-after-free          - Improper memory management
```

### Information Disclosure
```
Debug interfaces        - UART, JTAG left enabled
Verbose errors          - Stack traces, paths
Configuration files     - Exposed credentials
Firmware updates        - Unencrypted downloads
```

## Tool Proficiency

### Extraction Tools
```
binwalk v3           - Firmware extraction and analysis (Rust rewrite, faster, fewer false positives)
firmware-mod-kit     - Firmware modification toolkit
jefferson            - JFFS2 extraction
ubi_reader           - UBIFS extraction
sasquatch            - SquashFS with non-standard features
```

### Analysis Tools
```
Ghidra               - Multi-architecture disassembly
IDA Pro              - Commercial disassembler
Binary Ninja         - Modern RE platform
radare2              - Scriptable analysis
Firmware Analysis Toolkit (FAT)
FACT                 - Firmware Analysis and Comparison Tool
```

### Emulation
```
QEMU                 - Full system and user-mode emulation
Firmadyne            - Automated firmware emulation
EMUX                 - ARM firmware emulator
qemu-user-static     - Static QEMU for chroot emulation
Unicorn              - CPU emulation framework
```

### Hardware Tools
```
Bus Pirate           - Universal serial interface
Logic analyzer       - Protocol analysis
JTAGulator           - JTAG/UART discovery
Flashrom             - Flash chip programmer
ChipWhisperer        - Side-channel analysis
```

## Emulation Setup

### QEMU User-Mode Emulation
```bash
# Install QEMU user-mode
apt install qemu-user-static

# Copy QEMU static binary to extracted rootfs
cp /usr/bin/qemu-arm-static ./squashfs-root/usr/bin/

# Chroot into firmware filesystem
sudo chroot squashfs-root /usr/bin/qemu-arm-static /bin/sh

# Run specific binary
sudo chroot squashfs-root /usr/bin/qemu-arm-static /bin/httpd
```

### Full System Emulation with Firmadyne
```bash
# Extract firmware
./sources/extractor/extractor.py -b brand -sql 127.0.0.1 \
    -np -nk "firmware.bin" images

# Identify architecture and create QEMU image
./scripts/getArch.sh ./images/1.tar.gz
./scripts/makeImage.sh 1

# Infer network configuration
./scripts/inferNetwork.sh 1

# Run emulation
./scratch/1/run.sh
```

## Security Assessment

### Checklist
```markdown
[ ] Firmware extraction successful
[ ] File system mounted and explored
[ ] Architecture identified
[ ] Hardcoded credentials search
[ ] Web interface analysis
[ ] Binary security properties (checksec)
[ ] Network services identified
[ ] Debug interfaces disabled
[ ] Update mechanism security
[ ] Encryption/signing verification
[ ] Known CVE check
```

### Reporting Template
```markdown
# Firmware Security Assessment

## Device Information
- Manufacturer:
- Model:
- Firmware Version:
- Architecture:

## Findings Summary
| Finding | Severity | Location |
|---------|----------|----------|

## Detailed Findings
### Finding 1: [Title]
- Severity: Critical/High/Medium/Low
- Location: /path/to/file
- Description:
- Proof of Concept:
- Remediation:

## Recommendations
1. ...
```

## Ethical Guidelines

### Appropriate Use
- Security audits with device owner authorization
- Bug bounty programs
- Academic research
- CTF competitions
- Personal device analysis

### Never Assist With
- Unauthorized device compromise
- Bypassing DRM/licensing illegally
- Creating malicious firmware
- Attacking devices without permission
- Industrial espionage

## Response Approach

1. **Verify authorization**: Ensure legitimate research context
2. **Assess device**: Understand target device type and architecture
3. **Guide acquisition**: Appropriate firmware extraction method
4. **Analyze systematically**: Follow structured analysis workflow
5. **Identify issues**: Security vulnerabilities and misconfigurations
6. **Document findings**: Clear reporting with remediation guidance

## Limitations
- Use this skill only when the task clearly matches the scope described above.
- Do not treat the output as a substitute for environment-specific validation, testing, or expert review.
- Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.

© sickn33 · MIT · sickn33/agentic-awesome-skills

Похожие скиллы

Все скиллы по теме «Безопасность» →
competition-firmware-layout zhaoxuya520 Скилл competition-firmware-layout для Claude Code, Codex, Cursor и других платформ, разбирающий структуру прошивок, таблицы разделов и цепочки загрузки. CX Codex +1 109установок reverse-engineering-firmware-analysis DNYoussef Скилл reverse-engineering-firmware-analysis для Claude Code извлекает файловые системы из прошивок роутеров и IoT-устройств и помогает искать учётные данные и уязвимости. Анализ проводят в изолированной среде. CX Codex +1 1установок reverse-engineer 0xSteph Субагент reverse-engineer для Claude Code, который берёт на себя задачи статического анализа: работа с Ghidra, Radare2, IDA, JadX, декомпиляция Android APK, чтение дизассемблера и понимание структуры бинарника без запуска. CX Codex ★ 2 482звёзд репо azure-firmware-analysis MicrosoftDocs Помогает разбирать задачи Azure Firmware Analysis. Он подсказывает, как анализировать SBOM и CVE, настраивать доступ и развёртывать рабочие пространства. CX Codex +1 175установок ctf-reverse ljagiello Скилл ctf-reverse для Claude Code помогает агенту разбирать скомпилированные бинарники, распаковывать протекторы и анализировать виртуальные машины в CTF. CX Codex +1 11 100установок binary-analysis-patterns Dávid Balatoni Скилл binary-analysis-patterns помогает разбирать дизассемблированный код, восстанавливать логику программ и находить знакомые шаблоны в бинарных файлах. CX Codex +1 10 900установок

Из того же набора187

Весь набор →
claude-ally-health Скилл claude-ally-health структурирует заметки о симптомах и выписки в хронологию для приёма у врача. Помогает подготовить вопросы доктору и разобрать терминологию по авторитетным источникам. CX Codex +1 1установок marketing-psychology Скилл marketing-psychology помогает выбирать и проверять психологические модели для маркетинговых решений. Он пригодится, когда нужно связать поведение пользователя с конкретным изменением. CX Codex +1 1установок hugging-face-jobs Настраивает, тестирует и запускает вычисления на CPU, GPU и TPU в Hugging Face Jobs. Выполняет пакетную генерацию, инференс и обработку датасетов с сохранением на Hub. CX Codex +1 1установок memory-systems Скилл memory-systems для Claude Code помогает проектировать память агентов: от контекста сессии до долговременного и графового хранения. Помогает сохранять состояние между запусками. CX Codex +1 1установок llm-application-dev-prompt-optimize Скилл llm-application-dev-prompt-optimize переводит черновые инструкции в готовые промпты через цепочки рассуждений и проверки на регрессию. Помогает контролировать задержку и стоимость ответов модели. CX Codex +1 1установок accessibility-compliance-accessibility-audit Скилл accessibility-compliance-accessibility-audit проверяет страницы и пользовательские сценарии по заданному уровню WCAG. Он помогает найти барьеры для клавиатуры, скринридера, фокуса и контраста. CX Codex +1 1установок dependency-management-deps-audit Скилл dependency-management-deps-audit проверяет зависимости проекта на известные уязвимости, лицензионные конфликты и устаревшие пакеты, а затем расставляет порядок починки. CX Codex +1 1установок security-scanning-security-dependencies Скилл security-scanning-security-dependencies находит уязвимости в зависимостях проекта, формирует SBOM и готовит план обновления пакетов без спонтанных правок кодовой базы. CX Codex +1 1установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой